I documenti pubblici di un'associazione

GET

/v1/aps/{slug}/documents

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

• Vimine API

I documenti che l’associazione ha reso pubblici nella sua libreria — un atto costitutivo, uno statuto precedente, altri atti — ciascuno con tipo, titolo, data e l’indirizzo del suo originale. Un verbale o i bilanci approvati non sono mai qui. Solo lettura; lo statuto e il regolamento in vigore hanno chiamate proprie.

Parametri

Parametri di percorso

slug

obbligatorio

string

Risposte

200

I documenti pubblici

Tipo di contenutoapplication/json

object

aps

obbligatorio

object

slug

obbligatorio

string

name

obbligatorio

string

documents

obbligatorio

Array<object>

object

uid

obbligatorio

string formato: uuid

kind

obbligatorio

Founding_act · past_statute · other (un verbale o i bilanci non sono mai pubblici)

string

Valori ammessi: founding_act past_statute accounts minutes other

title

obbligatorio

string

act_date

La data dell’atto

string formato: date

nullable

period

L’esercizio dei bilanci (2025, 2025/2026)

string

nullable

pages

integer

nullable

bytes

integer

nullable

content_type

Application/pdf, image/jpeg o image/png

string

nullable

sha256

SHA-256 dell’originale come caricato

string

nullable

url

obbligatorio

GET risponde 302 verso un collegamento all’originale valido quindici minuti — chiedetelo quando serve, non conservatelo

string formato: uri

Esempio

{
  "documents": [
    {
      "kind": "founding_act"
    }
  ]
}

400

Richiesta non valida

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Associazione sconosciuta, o senza presenza pubblica

429

Troppe richieste

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Errore interno

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}