v1

latestOpenAPI 3.1.0© Modulr Finance2026-08-04207430590.4 KB

Cards

View the details of existing cards by account

get/accounts/{accountId}/cards

Path parameters

accountIdstring required

Account ID

Query parameters

Statuses of cards to be retrieved

pageinteger

sizeinteger

Response

Cards returned successfully

sizeinteger required

Page size

totalSizeinteger required

Total count

pageinteger required

Current page number, 0 based; i.e first-page = 0, second-page = 1

totalPagesinteger required

Total pages

Example response

{
  "content": [
    {
      "id": "V000000001",
      "holder": {
        "title": "Mr",
        "firstName": "Joe",
        "lastName": "Bloggs",
        "billingAddress": {
          "addressLine1": "Floor 10",
          "addressLine2": "80 George Street",
          "postTown": "EDINBURGH",
          "postCode": "EH2 3BU",
          "country": "GB"
        },
        "dateOfBirth": "2001-01-01",
        "mobileNumber": "+447123456000",
        "email": "cardholder@example.com"
      },
      "expiry": "2018-12",
      "currency": "GBP",
      "limit": "1000.00",
      "maxLimit": "4000.00",
      "spend": "250.00",
      "externalRef": "TTQ_51211",
      "maskedPan": "527095******3544",
      "cardType": "Business",
      "cardScheme": "MASTERCARD",
      "accountBid": "A020N8PD",
      "productId": "O210003A",
      "format": "PHYSICAL",
      "constraints": {
        "mccWhitelist": [
          "1000",
          "1002-3000",
          "5060"
        ],
        "authorisation": {
          "spend": [
            {
              "currency": "GBP"
            }
          ]
        }
      },
      "cancellationDate": "2025-01-01",
      "threeDSecureStatus": "ENROLLED",
      "authentication": {
        "otpSmsStatus": "ENROLLED",
        "knowledgeBaseStatus": "ENROLLED"
      },
      "shippingAddress": {
        "addressLine1": "Floor 10",
        "addressLine2": "80 George Street",
        "postTown": "EDINBURGH",
        "postCode": "EH2 3BU",
        "country": "GB"
      },
      "channelManagerId": "M883412312",
      "frequencyUsage": "SINGLE_USE"
    }
  ]
}