Listar CUITs

GET

/v1/cuits

const url = 'https://api.afippi.com/v1/cuits?limit=50&offset=0&categoria=A';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.afippi.com/v1/cuits?limit=50&offset=0&categoria=A' \
  --header 'Authorization: Bearer <token>'

Lista los CUITs administrados por tu cuenta, ordenados por nombre. Los filtros son opcionales y se combinan con AND; varias etiquetas se combinan con OR.

Authorizations

bearerAuth

Parameters

Query Parameters

limit

integer

default: 50 >= 1 <= 100

offset

integer

etiquetas

Array<string>

monotributista

boolean

autonomo

boolean

categoria

string

Allowed values: A B C D E F G H I J K

Responses

200

Página de CUITs.

application/json

object

data

required

Array

object

required

string

cuit

required

string

displayCuit

required

string

tipo

required

string

nombre

required

string

email

required

string | null

telefono

required

string | null

etiquetas

required

Array<string>

monotributista

required

boolean | null

autonomo

required

boolean | null

categoria

required

string | null

sistemaRegistralSyncedAt

required

string | null format: date-time

pagination

required

object

limit

required

integer

offset

required

integer

total

required

Cantidad total de registros que matchean la consulta.

integer

filters

required

Filtros efectivamente aplicados. Los que no se enviaron van en null.

object

etiquetas

required

Array<string> | null

monotributista

required

boolean | null

autonomo

required

boolean | null

categoria

required

string | null

Example

{
  "data": [
    {
      "cuit": "20111111112",
      "displayCuit": "20-11111111-2"
    }
  ]
}

400

Parámetros de consulta inválidos. El mensaje nombra el campo que falla.

application/json

object

error

required

string

Example

{
  "error": "'limit' debe ser un entero entre 1 y 100."
}

401

Token de acceso ausente o inválido.

application/json

object

error

required

string

Example

{
  "error": "Token de acceso ausente o inválido."
}

403

La suscripción de la cuenta no está activa.

application/json

object

error

required

string

Example

{
  "error": "Tu suscripción no está activa. Suscribite en https://app.afippi.com/dashboard/subscription para volver a acceder a tus datos."
}

429

Se superó el límite por minuto o la cuota mensual.

application/json

object

error

required

string

Example

{
  "error": "Se superó el límite de solicitudes. Intentá nuevamente más tarde."
}

500

Error interno del servidor.

application/json

object

error

required

string

Example

{
  "error": "Error interno del servidor."
}