Upgrade your account to a developer account to use the API function.

Create card check

POST /customers/cards/single_check

Create card detection, request /customers/cards/single_check interface to create a card detection task. Each call returns the result synchronously.

Single_check return the task ID and request the customers/cards/query interface to obtain the inspection result. We recommend obtaining the inspection result synchronously.

Headers

Key	Value
`Content-Type`	application/json
`Authorization`	Bearer {api_key}

Parameters

Field	Type	Description
`card_number`	string	card number.
`exp_month`	string	card expiration month.
`exp_year`	string	card expiration year.
`cvv`	string	security code.

Response

Field	Type	Description
`status`	string	`success` `failure`
`message`	string	message.
`data`	object	`task_id` `check_result` (active、dead、retry、unavailable) `concurrent_requests` `balance` `fee` `total_calls`

Request Example

curl https://www.muxcheck.com/en/customers/cards/single_check \
-X POST \
-H 'Authorization: Bearer API_KEY' \
-H 'Content-Type: application/json' \
-d '{
    "card_number": "YOUR_CARD_NUMBER",
    "exp_month": "CARD_EXPIRATION_MONTH",
    "exp_year": "CARD_EXPIRATION_YEAR",
    "cvv": "CARD_SECURITY_CODE"
}'

Response Example

{
    "status": "success",
    "message": "Request processed successfully",
    "data": {
        "task_id": "efc7f527-0b74-4305-a99d-0927616f9d91",
        "check_result": "active",
        "concurrent_requests": "2",
        "balance": 8000,
        "fee": "0.0277",
        "total_calls": 1007
    }
}

Get check result

POST /customers/cards/query

Headers

Key	Value
`Content-Type`	application/json
`Authorization`	Bearer {api_key}

Parameters

Field	Type	Description
`task_id`	string	task id

Response

Field	Type	Description
`status`	string	`success` `failure`
`message`	string	message.
`data`	object	`check_result` `card_number`

Request Example

curl https://www.muxcheck.com/en/customers/cards/query \
-X POST \
-H 'Authorization: Bearer API_KEY' \
-H 'Content-Type: application/json' \
-d '{
    "task_id": "task id"
}'

Response Example

{
    "status": "success",
    "message": "Request processed successfully",
    "data": {
        "check_result": "active",
        "card_number": "379240078800001"
    }
}