List receipts

GET

https://api.jokoor.com/v1/pay/receipts

Last modified:2025-11-15 15:49:01

Maintainer:Not configured

OperationId:listReceipts

Get a paginated list of all payment receipts for your organization.

Authentication: Requires API key with read:invoices scope.

Automatic Filtering: Results are automatically filtered by your API key's mode (test/live). Test API keys only see test receipts, live API keys only see live receipts.

Use Cases:

View all receipts across all payment types (invoices, payment links, checkouts, donations)

Export receipt data for accounting/reporting

Reconcile payments with accounting systems

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200OK

application/json

Paginated list of receipts

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.jokoor.com/v1/pay/receipts?offset&limit' \
--header 'Authorization: Bearer <token>'

Response Example

200 - List of receipts

{
    "data": {
        "receipts": [
            {
                "id": "rec_1a2b3c4d5e6f",
                "receipt_number": "RCT-2024-001",
                "amount": "500.00",
                "currency": "GMD",
                "payment_method": "wave",
                "customer_name": "John Doe",
                "customer_email": "john@example.com",
                "customer_phone": "+2207654321",
                "org_name": "Acme Corp",
                "org_email": "billing@acme.com",
                "status": "completed",
                "created_at": "2024-01-15T14:30:00Z",
                "mode": "live",
                "livemode": true
            },
            {
                "id": "rec_9z8y7x6w5v4u",
                "receipt_number": "RCT-2024-002",
                "amount": "1250.00",
                "currency": "GMD",
                "payment_method": "qmoney",
                "customer_name": "Jane Smith",
                "customer_email": "jane@example.com",
                "org_name": "Acme Corp",
                "status": "completed",
                "created_at": "2024-01-16T10:15:00Z",
                "mode": "live",
                "livemode": true
            }
        ],
        "total": 45,
        "limit": 20,
        "offset": 0
    }
}

Modified at 2025-11-15 15:49:01

Get invoice receipts

Get receipt by ID