# Listar emisores

> `GET https://api.cfdi.express/v1/merchants` — Lista los emisores de la cuenta en el modo de tu llave, con paginación por cursor.

URL de esta página: https://cfdi.express/docs/api/listar-emisores
Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`)

### Query string

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `limit` | integer | no | Elementos por página. Entre 1 y 100. Default 10. |
| `starting_after` | string | no | Id del último emisor de la página anterior (cursor). |

## Ejemplos

### cURL

```bash
curl "https://api.cfdi.express/v1/merchants?limit=10" \
  -H "Authorization: Bearer sk_test_..."
```

## Respuesta

### 200 OK

```json
{
  "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. |

## Relacionados

- [POST /v1/merchants](https://cfdi.express/docs/api/crear-emisor) — Crear emisor
- [GET /v1/merchants/{id}](https://cfdi.express/docs/api/obtener-emisor) — Obtener emisor

---

Referencia completa: https://cfdi.express/docs/api · OpenAPI: https://api.cfdi.express/openapi.json · Llaves: https://dash.cfdi.express