API Documentation

Use our powerful API to integrate credit card checking directly into your own applications and services.

Check Card Endpoint

To check a card, send a POST request to the following endpoint with your API key and card details in the JSON body.

Sample Request (cURL)

curl -X POST \
-H "Content-Type: application/json" \
-d '{
  "action": "check_card",
  "apiKey": "YOUR_API_KEY_HERE",
  "card": {
    "number": "4000000000000002",
    "exp_month": "12",
    "exp_year": "2028",
    "cvc": "123"
  }
}' \
https://checkcards.xyz/api.php

Sample Request (Python)

import requests
import json

url = "https://checkcards.xyz/api.php"

payload = {
  "action": "check_card",
  "apiKey": "YOUR_API_KEY_HERE",
  "card": {
    "number": "4000000000000002",
    "exp_month": "12",
    "exp_year": "2028",
    "cvc": "123"
  }
}

headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=json.dumps(payload))

# The status is in the 'status' field
result = response.json()
if result.get('status') == 'LIVE':
    print(f"LIVE: {result['message']}")
elif result.get('status') == 'DEAD':
    print(f"DEAD: {result['message']}")
else:
    print(f"ERROR: {result['message']}")

Sample Responses

The API returns a JSON object. The most important field is status, which will be "LIVE", "DEAD", or indicate an error like "INSUFFICIENT_FUNDS".

{
  "status": "LIVE",
  "message": "Success - Card is valid.",
  "stripe_code": "succeeded",
  "newCredits": 499999,
  "success": true
}

{
  "status": "DEAD",
  "message": "Your card was declined.",
  "stripe_code": "card_declined",
  "newCredits": 499079,
  "success": true
}

{
  "success": false,
  "status": "INSUFFICIENT_FUNDS",
  "message": "Insufficient credits.",
  "newCredits": 0
}

{
  "success": false,
  "status": "INVALID_KEY",
  "message": "Invalid API Key.",
  "newCredits": null
}