Saltar al contenido
Almanac.ar

Informe por CUIT · Endpoints

Consultar informes

Dos formas de leer lo que tu cuenta ya generó: la lista completa, o un informe puntual por id. Mismo criterio de acceso en las dos: sólo lo que tu cuenta generó (o admin) — nunca el informe de otra cuenta.

Listar tus informes

GET/v1/reports

Parámetros

cuitstring (query)

Filtro por substring del CUIT, con o sin guiones.

limitinteger (query)

Default 10, máximo 50.

offsetinteger (query)

Default 0.

Respuesta 200

items[]ReportListItem[]

id, cuit, cuit_formateado, denominacion (y denominacion_origen: de dónde se resolvió el nombre), status, generated_at, created_at.

has_moreboolean

Si hay más páginas después de esta.

Errores

401unauthenticated

Sin sesión ni API key.

403account_suspended · channel_disabled

Cuenta suspendida, o tu plan no habilita el canal API.

429rate_limited

Demasiadas llamadas seguidas — trae Retry-After.

curl -H "Authorization: Bearer alm_..." \
  "https://api.almanac.ar/v1/reports?limit=10"

Consola

ejemplo200
{
  "items": [
    {
      "id": "6e1b9e0a-8f3b-4e9a-9d1e-2b1a5b7d9c10",
      "cuit": "30000000007",
      "cuit_formateado": "30-00000000-7",
      "denominacion": "ACME S.A.",
      "denominacion_origen": "padron",
      "status": "ok",
      "generated_at": "2026-08-05T14:32:00.000Z",
      "created_at": "2026-08-05T14:32:00.000Z"
    }
  ],
  "has_more": false
}

Consultar un informe por id

GET/v1/reports/{id}

Parámetros

idstring (path)requerido

El informe_id devuelto por POST /v1/reports o GET /v1/reports.

Respuesta 200

Mismo shape que la respuesta de POST /v1/reports (sin cache_hit/tipo_accion/costo_unidades — esos son de la generación, no del informe en sí): cuit, informe_id, sections, status, generated_at.

Errores

401unauthenticated

Sin sesión ni API key.

403account_suspended · channel_disabled

Cuenta suspendida, o tu plan no habilita el canal API.

404not_found

No existe, o pertenece a otra cuenta.

429rate_limited

Demasiadas llamadas seguidas — trae Retry-After.

curl -H "Authorization: Bearer alm_..." \
  https://api.almanac.ar/v1/reports/6e1b9e0a-8f3b-4e9a-9d1e-2b1a5b7d9c10

Consola

ejemplo200
{
  "cuit": "30000000007",
  "informe_id": "6e1b9e0a-8f3b-4e9a-9d1e-2b1a5b7d9c10",
  "sections": {
    "identidad": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01",
      "status": "ok"
    }
  },
  "status": "ok",
  "generated_at": "2026-08-05T14:32:00.000Z"
}
Consultar — GET /v1/reports — Informe por CUIT — Almanac · Almanac