Ir al contenido

Listar los catálogos públicos de la DIAN

GET
/v1/catalogs
curl --request GET \
--url https://example.com/v1/catalogs

Devuelve las tablas de códigos de la DIAN disponibles (municipios, departamentos, unidades de medida, impuestos, responsabilidades fiscales, medios de pago, monedas, INCOTERMS, conceptos de corrección y eventos RADIAN). No requiere API key.

Los catálogos de la DIAN disponibles

Media typeapplication/json
object
data
required

Los catálogos de la DIAN disponibles

Array<object>

Un catálogo público de la DIAN y cuántos registros tiene

object
name
required

El nombre del catálogo, usado en /v1/catalogs/{name}

string
Allowed values: departments municipalities units taxes tax-responsibilities id-types payment-means currencies incoterms credit-note-concepts debit-note-concepts support-adjustment-concepts pos-adjustment-concepts radian-events radian-claim-concepts due-diligence generation-forms
description
required

Qué lista el catálogo y de qué tabla de la DIAN proviene

string
count
required

Cuántos registros contiene el catálogo

integer
>= -9007199254740991 <= 9007199254740991

Example

{
"data": [
{
"name": "departments"
}
]
}

Error del servicio

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}