Skip to content
Vimine for developers
EN

An association's public documents

GET
/v1/aps/{slug}/documents
curl --request GET \
  --url https://api.vimine.network/v1/aps/example/documents

The documents the association made public in its library — an atto costitutivo, an earlier statuto, other acts — each with its kind, title, date and the address of its original. A verbale or the approved accounts are never here. Read-only; the statuto and the regolamento in force have their own routes.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
slug
required
string

Responses

Section titled “Responses”

200

Section titled “200”

The public documents

Media typeapplication/json
object
aps
required
object
slug
required
string
name
required
string
documents
required
Array<object>
object
uid
required
string format: uuid
kind
required

Founding_act · past_statute · other (a verbale or the accounts are never public)

string
Allowed values: founding_act past_statute accounts minutes other
title
required
string
act_date

The act’s date

string format: date
nullable
period

The esercizio of accounts (2025, 2025/2026)

string
nullable
pages
integer
nullable
bytes
integer
nullable
content_type

Application/pdf, image/jpeg or image/png

string
nullable
sha256

SHA-256 of the original as uploaded

string
nullable
url
required

GET answers 302 to a link to the original valid fifteen minutes — ask for it when you need it, never store it

string format: uri
Example
{
  "documents": [
    {
      "kind": "founding_act"
    }
  ]
}

400

Section titled “400”

Invalid request

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Section titled “404”

Unknown association, or one with no public presence

429

Section titled “429”

Rate limited

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Section titled “500”

Internal error

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}