Consultar CSD
GEThttps://api.cfdi.express/v1/merchants/{id}/csdAPI key
Metadatos del certificado activo: número de serie, RFC, vigencia y si está registrado con el PAC. Nunca devuelve la llave privada.
Úsalo para alertar a tus usuarios antes de que el CSD venza: status pasa a expired cuando validTo queda en el pasado y a partir de ahí el timbrado falla.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...Parámetros
Parámetros de ruta
| Campo | Tipo | Descripción |
|---|---|---|
| idreq | string | Id del emisor. |
Ejemplos
cURL
curl https://api.cfdi.express/v1/merchants/mkq2f8v3x1t7p9d4n6c0b5rz/csd \
-H "Authorization: Bearer sk_test_..."Respuesta
200 OK
{
"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"
}Errores
| Status | code | Cuándo aparece |
|---|---|---|
| 401 | unauthorized | Falta el header Authorization o la llave es inválida. |
| 404 | not_found | El emisor no existe o todavía no tiene CSD. |