---
updatedAt: 2026-07-17T18:55:27.000Z
agentTools:
  projectIndex: https://developers.tabapay.com/llms.txt
---

# 6. Query Card

```shell cURL
curl -H 'Authorization: Bearer *Redacted*' -H "Content-type: application/json" -d '{
    "card": {
        "accountNumber": "4111111111111111",
        "expirationDate": "202708",
        "securityCode": "232"
    },
    "owner": {
        "name": {
            "first": "Test",
            "last": "Name"
        },
        "address": {
            "line1": "123 Street",
            "city": "San Francisco",
            "state": "CA",
            "zipcode": "94104",
            "country": "840"
        }
    },
    "currency": "840",
    "timeout": "39"
}' 'https://FQDN/v1/clients/ClientID/cards'
```

```javascript JavaScript
const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    authorization: 'Bearer *Redacted*'
  },
  body: {
    "card": {
        "accountNumber": "4111111111111111",
        "expirationDate": "202708",
        "securityCode": "232"
    },
    "owner": {
        "name": {
            "first": "Test",
            "last": "Name"
        },
        "address": {
            "line1": "123 Street",
            "city": "San Francisco",
            "state": "CA",
            "zipcode": "94104",
            "country": "840"
        }
    },
    "currency": "840",
    "timeout": "39"
}
};


fetch('https://FQDN/v1/clients/ClientID/cards', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```

```python Python
import requests

url = "https://FQDN/v1/clients/ClientID/cards"

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer *Redacted*"
}

body = {
  "card": {
        "accountNumber": "4111111111111111",
        "expirationDate": "202708",
        "securityCode": "232"
    },
    "owner": {
        "name": {
            "first": "Test",
            "last": "Name"
        },
        "address": {
            "line1": "123 Street",
            "city": "San Francisco",
            "state": "CA",
            "zipcode": "94104",
            "country": "840"
        }
    },
    "currency": "840",
    "timeout": "39"
}

response = requests.post(url, headers=headers, json=body)

print(response.text)
```

```json Response Example
{
    "SC": 200,
    "EC": "0",
    "card": {
        "pull": {
            "enabled": true,
            "network": "Visa",
            "type": "Credit",
            "regulated": true,
            "currency": "840",
            "country": "840"
        },
        "push": {
            "enabled": true,
            "network": "Visa",
            "type": "Credit",
            "availability": "Immediate",
            "regulated": true,
            "currency": "840",
            "country": "840"
        },
        "bin": "411111",
        "last4": "1111",
        "nameFI": "FORD Instiution"
    }
}
```

# Headers

<!-- shell@1 -->
<!-- javascript@1-8 -->
<!-- python@5-9 -->

All Content-Type is application/json  
All Authorization is of the form: Bearer _redacted_. 

The _redacted_ Bearer Token is in your credentials file.

Note: All requests should be in a compressed format.

# Compact JSON Format

<!-- shell@ -->
<!-- javascript@ -->
<!-- python@ -->

This recipe JSON example is presented in a human-readable format to enhance the documentation experience. However, all requests made in both Sandbox and Production environments should use a compact JSON format.

Refer to [Getting Started with TabaPay](https://developers.tabapay.com/reference/getting-started#compact-json) for more info.

# Card Number

<!-- shell@2-6 -->
<!-- javascript@9-14 -->
<!-- python@11-16 -->

Use a sandbox card number from <https://developers.tabapay.com/docs/sandbox-test-cards>

# Owner

<!-- shell@7-11 -->
<!-- javascript@15-19 -->
<!-- python@17-21 -->

Includes name—first and last, as well as address, and phone (listed in step 4-5). Required.

# Address

<!-- shell@12-18 -->
<!-- javascript@20-26 -->
<!-- python@22-28 -->

Include street, city, state, zip, and country code under address. 

Find country codes at <https://developers.tabapay.com/reference/country-codes>

# Currency & Timeout

<!-- shell@20-21 -->
<!-- javascript@28-29 -->
<!-- python@30-31 -->

Find the currency code at <https://developers.tabapay.com/reference/currency-numbers>

Default timeout is 39.

# URL

<!-- shell@22 -->
<!-- javascript@32 -->
<!-- python@3 -->

https\://FQDN/v1/clients/ClientID/cards

Replace <<glossary:FQDN>> with your URL.

Swap out ClientID with your own.