GET
/
card
/
{cardId}
curl --request GET \
  --url https://api.joinslash.com/card/{cardId} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "accountId": "<string>",
  "last4": "<string>",
  "name": "<string>",
  "expiryMonth": "<string>",
  "expiryYear": "<string>",
  "status": "active",
  "isPhysical": true,
  "pan": "<string>",
  "cvv": "<string>",
  "cardGroupId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "spendingConstraint": {
    "merchantCategoryRule": {
      "merchantCategories": [
        "<string>"
      ],
      "restriction": "allowlist"
    },
    "merchantRule": {
      "merchants": [
        "<string>"
      ],
      "restriction": "allowlist"
    },
    "spendingRule": {
      "utilizationLimit": {
        "timezone": "<string>",
        "limitAmount": {
          "amountCents": 123
        },
        "preset": "daily",
        "startDate": "<string>"
      },
      "utilizationLimitV2": [
        {
          "timezone": "<string>",
          "limitAmount": {
            "amountCents": 123
          },
          "preset": "daily",
          "startDate": "<string>"
        }
      ],
      "transactionSizeLimit": {
        "minimum": {
          "amountCents": 123
        },
        "maximum": {
          "amountCents": 123
        }
      }
    }
  },
  "avsAddress": {
    "addressLine1": "<string>",
    "addressLine2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "country": "<string>"
  },
  "userData": {}
}

To reveal the full PAN or CVV of the card, you must:

  1. Set the query params include_pan=true and/or include_cvv=true.
  2. Set the base URL of the request to https://vault.joinslash.com.
curl --request GET \
  --url "https://vault.joinslash.com/card/<cardId>?include_pan=true&include_cvv=true" \
  --header 'X-API-Key: <x-api-key>'

Authorizations

X-API-Key
string
headerrequired

Authentication from public API requests

Path Parameters

cardId
string
required

Query Parameters

include_pan
enum<string>
Available options:
true,
false
include_cvv
enum<string>
Available options:
true,
false

Response

200 - application/json
id
string
required
accountId
string
required

The account that this card is associated with

last4
string
required

The last 4 digits of the card number

name
string
required

The name assigned to the card that appears on the user dashboard

expiryMonth
string
required

The month the card expires formatted as MM (01, 02, ..., 12)

expiryYear
string
required

The year the card expires formatted as YYYY (2024, 2025, ...)

status
enum<string>
required

The status of the card

Available options:
active,
paused,
inactive,
closed
isPhysical
boolean
required

When true, a physical card has been issued. Otherwise, this is a virtual card.

pan
string

This field contains the full PAN which will only be sent on a request for a single card when you set the query param "include_pan" to "true"

cvv
string

This field will contain full CVV which will only be sent on a request for a single card when you set the query param "include_pan" to "true"

cardGroupId
string

The card group the card belongs to.

createdAt
string
spendingConstraint
object

The spending constraint applied to the card

avsAddress
object

The avs address locked applied to this card

userData
object

Arbitrary information that can be attached to the card. See the PATCH /card/{cardId} endpoint for more details on how to add user data.

List cardsGet card authorization events