SLslashfi

List cards

Changed on

List the cards the caller can see, physical cards first, then by name. Closed cards are left out unless status asks for them.

get/v2/cards

Request

  • Base URL
    https://api.slash.com
  • URL
    https://api.slash.com/v2/cards
  • Auth
    API key in header X-API-Key

Query parameters

cursorstring

The opaque metadata.nextCursor value from the previous page. It carries that page's filters, page size and ordering, so pass it on its own; see Pagination.

limitinteger

Number of items per page, from 1 to 100. The page size is carried inside metadata.nextCursor, so later pages keep the same size unless limit is passed again to change it.

statusstring[]

Return cards in these statuses. Defaults to every status but closed.

type'virtual' | 'physical'

Return virtual or physical cards.

accountIdstring

Return cards issued on one account.

virtualAccountIdstring

Return cards on one virtual account.

cardGroupIdstring

Return cards in one card group.

cardholderUserIdstring

Return cards held by one user.

searchstring

Match on the card name, its last four digits or its id.

Response

A page of cards.

Example response

{
  "items": [
    {
      "id": "c_2rj4l7hmrrrcv",
      "name": "Ads – Meta",
      "last4": "4242",
      "expiryMonth": 9,
      "expiryYear": 2030,
      "accountId": "sa_group_2rj4l7hmrrrcv",
      "virtualAccountId": "subaccount_2rj4l7hmrrrcv",
      "cardGroupId": "card_group_2rj4l7hmrrrcv",
      "cardProductId": "card_product_2rj4l7hmrrrcv",
      "cardholderUserId": "u_2rj4l7hmrrrcv",
      "controls": {
        "limit": {
          "amount": {
            "amount": 500000,
            "currency": "USD"
          },
          "period": "monthly"
        },
        "transactionLimit": {
          "amount": 250000,
          "currency": "USD"
        },
        "merchantCategoryCodes": {
          "mode": "block",
          "values": [
            "7995"
          ]
        }
      },
      "physical": {
        "secondLine": "Computer Services"
      }
    }
  ]
}

Changes