API

La API de Afippi te da acceso programático a los datos fiscales que sincronizamos desde ARCA para los CUITs de tu estudio. Se sirve desde https://api.afippi.com y está versionada bajo /v1.

Qué podés hacer

Leer los datos que Afippi ya recolectó de ARCA, y dar de alta y editar los clientes de tu estudio. Todas las respuestas son JSON.

Recurso	Qué devuelve
`GET /v1/cuits`	Los CUITs que administrás, filtrables por etiqueta y condición fiscal
`GET /v1/tags`	Las etiquetas de tu cuenta (nombre y color)
`GET /v1/cuits/{cuit}/mis-comprobantes/emitidos`	Comprobantes emitidos por el CUIT
`GET /v1/cuits/{cuit}/mis-comprobantes/recibidos`	Comprobantes recibidos por el CUIT
`GET /v1/cuits/{cuit}/sct`	Deuda, vencimientos y DDJJ del Sistema de Cuentas Tributarias
`GET /v1/cuits/{cuit}/ccma`	Saldos deudor y acreedor de la CCMA
`GET /v1/cuits/{cuit}/ccma/movimientos`	Movimientos de la CCMA, paginados por período
`GET /v1/cuits/{cuit}/dfe`	Notificaciones del Domicilio Fiscal Electrónico

Y tres endpoints de escritura, que hay que habilitar por cuenta:

Recurso	Qué hace
`POST /v1/cuits`	Da de alta un cliente	Enterprise
`PATCH /v1/cuits/{cuit}`	Edita un cliente	Enterprise
`DELETE /v1/cuits/{cuit}`	Elimina un cliente	Enterprise

Cómo se habilitan y qué se puede editar está en Escritura. El detalle de cada endpoint, con todos sus parámetros y campos, está en la Referencia.

Primer pedido

curl https://api.afippi.com/v1/cuits \
  -H "Authorization: Bearer $AFIPPI_API_TOKEN"

{
  "data": [
    {
      "id": "cuit-public-id",
      "cuit": "20123456789",
      "displayCuit": "20-12345678-9",
      "tipo": "persona-fisica",
      "nombre": "Pérez, Juan",
      "email": "juan@afippi.com",
      "telefono": null,
      "etiquetas": ["Agus"],
      "monotributista": true,
      "autonomo": false,
      "categoria": "A",
      "sistemaRegistralSyncedAt": "2026-07-20T14:32:11.000Z"
    }
  ],
  "pagination": { "limit": 50, "offset": 0, "total": 137 },
  "filters": {
    "etiquetas": null,
    "monotributista": null,
    "autonomo": null,
    "categoria": null
  }
}

Antes de empezar

Hay cinco cosas que conviene leer antes de escribir código contra la API:

Autenticación — cómo generar y usar tu token.
Paginación — cómo recorrer resultados largos.
Sincronización — por qué syncedAt importa tanto como los datos.
Errores y límites — qué esperar cuando algo sale mal.
Escritura — cómo crear, editar y eliminar clientes.

Especificación OpenAPI

El spec completo está publicado en https://api.afippi.com/openapi.json. Lo podés importar en Postman, Insomnia o cualquier cliente que genere código a partir de OpenAPI 3.1.

Asistentes de IA

Además de HTTP, Afippi expone los mismos datos como servidor MCP en https://api.afippi.com/mcp, autenticado con OAuth. Si lo que querés es conectar ChatGPT o Claude a tu cuenta, no necesitás esta API: seguí Asistentes de IA.