Search By Pan

Search for card by PAN

post/v1/cards/search_by_pan

Get card configuration such as spend limit and state. Customers must be PCI compliant to use this endpoint. Please contact support@lithic.com for questions. Note: this is a POST endpoint because it is more secure to send sensitive data in a request body than in a URL.

Body Parameters

panstring

The PAN for the card being retrieved.

Returns

Request example Request

curl https://api.lithic.com/v1/cards/search_by_pan \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "pan": "4111111289144142"
    }'

200 Example

{
  "token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
  "account_token": "f3f4918c-dee9-464d-a819-4aa42901d624",
  "card_program_token": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "created": "2021-06-28T22:53:15Z",
  "funding": {
    "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created": "2019-12-27T18:11:19.117Z",
    "last_four": "xxxx",
    "state": "DELETED",
    "type": "DEPOSITORY_CHECKING",
    "account_name": "account_name",
    "nickname": "x"
  },
  "last_four": "xxxx",
  "pin_status": "OK",
  "spend_limit": 1000,
  "spend_limit_duration": "ANNUALLY",
  "state": "CLOSED",
  "type": "MERCHANT_LOCKED",
  "auth_rule_tokens": [
    "string"
  ],
  "cardholder_currency": "USD",
  "digital_card_art_token": "00000000-0000-0000-1000-000000000000",
  "exp_month": "06",
  "exp_year": "2027",
  "hostname": "hostname",
  "memo": "New Card",
  "pending_commands": [
    "string"
  ],
  "product_id": "1",
  "replacement_for": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "cvv": "776",
  "pan": "4111111289144142"
}