Skip to main content
GET
/
cards
List cards
curl --request GET \
  --url https://api-dev.paygen.online/cards \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 123,
  "message": "<string>",
  "data": [
    {
      "_id": "<string>",
      "debitAccountId": "<string>",
      "cardHolderId": "<string>",
      "type": "virtual",
      "brand": "Mastercard",
      "currency": "NGN",
      "metadata": {},
      "status": "<string>",
      "spendingControls": {
        "channels": {
          "atm": true,
          "pos": true,
          "web": true,
          "mobile": true
        },
        "allowedCategories": [
          "<string>"
        ],
        "blockedCategories": [
          "<string>"
        ],
        "spendingLimits": [
          {
            "amount": 123,
            "interval": "<string>",
            "categories": [
              "<string>"
            ]
          }
        ]
      },
      "enable2FA": true,
      "disposable": true
    }
  ],
  "meta": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "pages": 123,
    "sort": "<string>",
    "fields": "<string>",
    "search": "<string>",
    "searchIn": "<string>",
    "filter": "<string>"
  },
  "filter": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1
Required range: x >= 1
limit
integer
default:20
Required range: 1 <= x <= 200
sort
string

Comma-separated sort expression such as name,-createdAt.

fields
string

Comma-separated field projection such as name,emailAddress,createdAt.

Free-text search term.

searchIn
string

Comma-separated list of fields to search.

filter
string

JSON or querystring-style filter expression such as status=Active or balance.gte=100.

populate
string

Populate related fields, for example owner,team or owner:email name;team:title.

Response

200 - application/json

Data fetched successfully.

statusCode
integer
required
message
string
required
data
object[]
meta
object
filter
object