List payments with transactions

List and filter payments with their associated transactions. Supports pagination, sorting, and advanced filtering options.

Supported filters:

• Store IDs
• Payment status and sub-status
• Currency and amount
• Card details (last4, brand, expiry)
• Customer information (email, name)
• Date ranges
• Dispute status and type

POST /api/public/v1/payments

cURL

basic

curl --request POST \
  --url https://api.tagada.io/api/public/v1/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pagination": {
    "page": 1,
    "pageSize": 20
  }
}
'

200

{
  "payments": [
    {
      "id": "pay_123xyz",
      "amount": 2999,
      "currency": "USD",
      "status": "succeeded",
      "createdAt": "2024-03-20T10:30:00Z",
      "customer": {
        "email": "[e-mail]",
        "firstName": "John",
        "lastName": "Doe"
      },
      "paymentInstrument": {
        "card": {
          "last4": "4242",
          "brand": "visa",
          "expYear": 2025,
          "expMonth": 12
        }
      },
      "transactions": [
        {
          "id": "txn_123",
          "type": "purchase",
          "status": "succeeded",
          "amount": 2999,
          "currency": "USD"
        }
      ]
    }
  ],
  "total": 1,
  "pageCount": 1
}

Authorizations

Authorization · string · header · required

Enter your API key as: Bearer your-api-key

Body

application/json

pagination · object

Show child attributes

useCursor · boolean · default: false

cursor · string

sortBy · object

Show child attributes

filters · object

Show child attributes

Response

200

application/json

Successful response