Payments

List payment intents

GET/v1/payment_intents

Newest first, cursor-paginated with next_cursor. Default 25, maximum 100.

Parameters

statusstringin query: One of pending, succeeded, failed, reversed, refunded, partially_refunded.
referencestringin query
created_afterstring (date-time)in query
created_beforestring (date-time)in query
limitintegerin query: Default 25.
cursorstringin query

Responses

200A page of intents
400Invalid request
401Missing, invalid or revoked API key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.

{ "object": "list", "data": [ { "id": "pi_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "object": "payment_intent", "livemode": false, "status": "pending", "amount": 125000, "currency": "KES", "method": "mpesa_stk", "reference": "ORDER-1001", "description": "description", "phone": "+254708374149", "customer_email": "amina@example.co.ke", "metadata": {}, "provider_code": "provider code", "receipt": "receipt", "checkout_url": "checkout url", "reconciliation_status": "matched_exact", "created_at": "2026-10-22T09:30:00.000Z", "succeeded_at": "2026-10-22T09:30:00.000Z", "attempts": [ { "id": "pa_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "object": "payment_attempt", "provider": "daraja", "status": "pending", "provider_ref": "provider ref", "failure_code": "failure code", "created_at": "2026-10-22T09:30:00.000Z", "finished_at": "2026-10-22T09:30:00.000Z" } ] } ], "has_more": false, "next_cursor": "next cursor" }

List payment intents

GET/v1/payment_intents

Newest first, cursor-paginated with next_cursor. Default 25, maximum 100.

Parameters

statusstringin query: One of pending, succeeded, failed, reversed, refunded, partially_refunded.
referencestringin query
created_afterstring (date-time)in query
created_beforestring (date-time)in query
limitintegerin query: Default 25.
cursorstringin query

Responses

200A page of intents
400Invalid request
401Missing, invalid or revoked API key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.