# Listar complementos de pago

> `GET https://api.cfdi.express/v1/payments` — Lista los complementos de pago de la cuenta con filtros por factura, emisor, estatus, UUID y fechas.

URL de esta página: https://cfdi.express/docs/api/listar-complementos-de-pago
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 REP de la página anterior (cursor). |
| `merchantId` | string | no | Filtra por emisor. |
| `invoiceId` | string | no | Filtra por la factura pagada. |
| `status` | string | no | stamping, stamped, stamp_failed, cancel_pending o cancelled. |
| `uuid` | string | no | Busca por folio fiscal del REP. |
| `createdFrom` | string | no | Fecha ISO 8601 mínima de creación. |
| `createdTo` | string | no | Fecha ISO 8601 máxima de creación. |

## Ejemplos

### cURL

```bash
curl -G https://api.cfdi.express/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  --data-urlencode "invoiceId=inv7k3q9x2m4v1t8p6d0n5cb"
```

## Respuesta

### 200 OK

```json
{
  "object": "list",
  "data": [
    {
      "id": "pay9x2m6q4k1v3p8d7n5c0bt",
      "object": "payment",
      "livemode": false,
      "status": "stamped",
      "invoiceId": "inv7k3q9x2m4v1t8p6d0n5cb",
      "merchantId": "mkq2f8v3x1t7p9d4n6c0b5rz",
      "uuid": "5c9e7f22-1a3b-4d8e-9f01-2b3c4d5e6f70",
      "numParcialidad": 1,
      "monto": 2000.00,
      "formaPago": "03",
      "fechaPago": "2026-08-18T12:00:00.000Z",
      "saldoAnterior": 3670.00,
      "saldoInsoluto": 1670.00,
      "currency": "MXN",
      "files": { "status": "ready" },
      "cancellation": null,
      "stampedAt": "2026-08-18T18:31:12.006Z",
      "createdAt": "2026-08-18T18:31:10.554Z"
    }
  ],
  "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/invoices/{id}/payments](https://cfdi.express/docs/api/timbrar-complemento-de-pago) — Timbrar REP
- [GET /v1/payments/{id}](https://cfdi.express/docs/api/obtener-complemento-de-pago) — Obtener REP

---

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