Listar constancias

Ir al contenido

GET

/v1/retentions

Las constancias del emisor, las más recientes primero.

Autorización

bearerAuth

headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100. Por omisión 10.

Rango1 <= value <= 100

Por omisión10

starting_after?string

El id del último de la página anterior, para la siguiente.

issuer?string

El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo.

status?string

valid, canceled, rejected o processing.

Uno de"valid""canceled""rejected""processing"

recipient?string

RFC del receptor.

year?string

Ejercicio, 4 dígitos.

Cuerpo de la respuesta

Correcto.

application/json

response

object*string

Qué tipo de objeto es («invoice», «customer»…).

data*array<>

Los objetos de esta página.

has_more*boolean

true si hay más: pida la siguiente con starting_after igual al id del último.

url*string

La ruta de esta lista.

curl -X GET 'https://api.fiscalisto.com/v1/retentions' \  -H 'Authorization: Bearer fk_test_…'

{  "object": "list",  "data": [    {      "id": "ret_OufpKqnrvx9p5tENFcmUXpXJ58XxnF67kv",      "object": "retention",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "status": "valid",      "uuid": "9A6F6BF3-6786-4747-800A-C9964E6509AE",      "folio": 1,      "internal_folio": "RET1",      "date": "2026-10-24T10:15:42",      "code": "01",      "description": null,      "recipient": {        "foreign": false,        "tax_id": "PEPJ800101AB1",        "legal_name": "JUAN PEREZ PEREZ",        "zip": "33826",        "curp": null      },      "period": {        "year": 2026,        "from_month": 9,        "to_month": 9      },      "totals": {        "operation": 10000,        "taxed": 10000,        "exempt": 0,        "withheld": 2066.67      },      "taxes": [        {          "tax": "isr",          "base": 10000,          "amount": 1000,          "payment_type": "04"        },        {          "tax": "iva",          "base": 10000,          "amount": 1066.67,          "payment_type": "01"        }      ],      "cancellation": null,      "email": null,      "error": null,      "created_at": "2026-10-24T10:15:42-06:00",      "metadata": {        "proveedor": "42"      }    }  ],  "has_more": false,  "url": "/v1/retentions"}

Listar constancias

AutorizaciónCopiar enlace a esta sección

Parámetros de consultaCopiar enlace a esta sección

Cuerpo de la respuestaCopiar enlace a esta sección

Autorización

Parámetros de consulta

Cuerpo de la respuesta