Listar emisores
GEThttps://api.cfdi.express/v1/merchantsAPI key
Lista los emisores de la cuenta en el modo de tu llave, con paginación por cursor.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...Parámetros
Query string
| Campo | Tipo | Descripción |
|---|---|---|
| limit | integer | Elementos por página. Entre 1 y 100. Default 10. |
| starting_after | string | Id del último emisor de la página anterior (cursor). |
Ejemplos
cURL
curl "https://api.cfdi.express/v1/merchants?limit=10" \
-H "Authorization: Bearer sk_test_..."Respuesta
200 OK
{
"object": "list",
"data": [
{
"id": "mkq2f8v3x1t7p9d4n6c0b5rz",
"object": "merchant",
"livemode": false,
"rfc": "EKU9003173C9",
"legalName": "ESCUELA KEMPER URGATE",
"regimenFiscal": "601",
"zip": "42501",
"serie": "A",
"defaultClaveProdServ": "01010101",
"defaultClaveUnidad": "E48",
"csd": {
"object": "csd",
"serialNumber": "30001000000500003416",
"rfc": "EKU9003173C9",
"validFrom": "2023-05-18T00:00:00.000Z",
"validTo": "2027-05-18T00:00:00.000Z",
"status": "active",
"registeredWithPac": true,
"updatedAt": "2026-08-18T16:24:51.002Z"
},
"logoUrl": null,
"createdAt": "2026-08-18T16:20:03.114Z"
}
],
"has_more": false
}Errores
| Status | code | Cuándo aparece |
|---|---|---|
| 401 | unauthorized | Falta el header Authorization o la llave es inválida. |
| 429 | rate_limited | Excediste el límite de requests por minuto de tu cuenta (300 por default). La respuesta incluye Retry-After. |