Skip to main content
GET
/
v1
/
cards
/
{cardId}
Get card
curl --request GET \
  --url https://api.light.inc/v1/cards/{cardId} \
  --header 'Authorization: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyEntityName": "<string>",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerName": "<string>",
  "cardBalanceAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cardBalanceAccountLabel": "<string>",
  "currency": "USD",
  "form": "VIRTUAL",
  "status": "ACTIVE",
  "metadata": {
    "type": "VENDOR"
  },
  "threeDs": {
    "phoneNumber": {
      "countryCode": "UNDEFINED",
      "localNumber": "<string>"
    },
    "password": "<string>",
    "email": "<string>"
  },
  "vendorId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "vendorName": "<string>",
  "vendorAvatarUrl": "<string>",
  "description": "<string>",
  "bin": "<string>",
  "lastFour": "<string>",
  "cardholderName": "<string>",
  "limitIntervalSpend": 123,
  "limits": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amount": 123,
      "currency": "USD",
      "interval": "PER_TRANSACTION",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "type": "VENDOR"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

Path Parameters

​
cardId
string<uuid>
required

Response

default - application/json;charset=UTF-8

default response

List of records for the current page

​
id
string<uuid>
​
companyEntityId
string<uuid>
​
companyEntityName
string
​
companyId
string<uuid>
​
ownerId
string<uuid>
​
ownerName
string
​
cardBalanceAccountId
string<uuid>
​
cardBalanceAccountLabel
string
​
currency
string
Example:

"USD"

​
form
enum<string>

⚠️ This enum is not exhaustive; new values may be added in the future.

Available options:
VIRTUAL
​
status
enum<string>

⚠️ This enum is not exhaustive; new values may be added in the future.

Available options:
ACTIVE,
FROZEN,
CLOSED,
UPDATE_IN_PROGRESS
​
metadata
object
​
threeDs
object
​
vendorId
string<uuid>
​
vendorName
string
​
vendorAvatarUrl
string
​
description
string
​
bin
string
​
lastFour
string
​
cardholderName
string
​
limitIntervalSpend
integer<int64>
​
limits
object[]
​
createdAt
string<date-time>
​
updatedAt
string<date-time>
​
type
enum<string>

⚠️ This enum is not exhaustive; new values may be added in the future.

Available options:
VENDOR,
EMPLOYEE