Saltar a contenido

Listar documentos

GET /apientidades/v1/documentos/declaracion/{iddeclaracion}

Devuelve la lista de documentos disponibles para una declaración: informes de evaluación, justificantes de presentación, etc.

Parámetros de ruta

Parámetro Tipo Descripción
iddeclaracion int ID de la declaración

Ejemplo de petición

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/documentos/declaracion/5001" \
  -H "Authorization: Bearer $TOKEN" | jq .

import requests

BASE_URL = "https://apientidades-pro.transparenciacanarias.org/apientidades/v1"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get(
    f"{BASE_URL}/documentos/declaracion/5001",
    headers=headers
)
documentos = response.json()

for doc in documentos:
    tamano_kb = doc["tamanoBytes"] / 1024
    print(f"[{doc['tipoDescripcion']}] {doc['descripcion']} ({tamano_kb:.0f} KB)")

var response = await client.GetAsync($"{baseUrl}/documentos/declaracion/5001");
var json = await response.Content.ReadAsStringAsync();
var documentos = JsonConvert.DeserializeObject<List<DocumentoDto>>(json);

foreach (var doc in documentos)
{
    Console.WriteLine($"[{doc.TipoDescripcion}] {doc.Descripcion} ({doc.TamanoBytes / 1024} KB)");
}

Respuesta exitosa (200)

[
  {
    "id": 1,
    "tipo": 0,
    "tipoDescripcion": "Informe provisional",
    "registro": "REG-2024-001",
    "descripcion": "Informe de evaluación provisional",
    "tamanoBytes": 245760,
    "fechaSubida": "2025-06-15T10:30:00Z"
  },
  {
    "id": 2,
    "tipo": 1,
    "tipoDescripcion": "Informe definitivo",
    "registro": "REG-2024-002",
    "descripcion": "Informe de evaluación definitivo",
    "tamanoBytes": 312000,
    "fechaSubida": "2025-09-01T14:00:00Z"
  },
  {
    "id": 3,
    "tipo": 3,
    "tipoDescripcion": "Justificante de presentación de declaración",
    "registro": "REG-2024-003",
    "descripcion": "Justificante de presentación",
    "tamanoBytes": 45200,
    "fechaSubida": "2025-03-10T09:15:00Z"
  }
]

Campos de cada documento

Campo Tipo Descripción
id int Identificador único del documento
tipo int Código del tipo de documento (0-4)
tipoDescripcion string Descripción legible del tipo
registro string Número de registro del documento
descripcion string Descripción del documento
tamanoBytes int Tamaño del fichero en bytes
fechaSubida datetime Fecha de creación del documento (ISO 8601)

Tipos de documento

Tipo Descripción
0 Informe provisional
1 Informe definitivo
2 Informe definitivo detallado
3 Justificante de presentación de declaración
4 Justificante de presentación de alegaciones

Lista vacía

Si la declaración aún no tiene documentos generados (por ejemplo, si la evaluación no ha llegado a la fase de calificaciones), la respuesta será un array vacío [].

Errores posibles

Código Descripción
401 Token ausente, expirado o inválido
404 La declaración no existe o no pertenece a la entidad