API Documentation
A simple HTTP API to create and manage checking tasks programmatically.
Base URL
https://t0check.co/apiAuthentication
Every request must include your API key in the X-API-Key header. Manage keys on the API Keys page.
Response Format
All responses share the same envelope. code is 0 on success; a non-zero code means the request was rejected and message explains why.
{ "code": 0, "message": "success", "data": {} }Rate Limit
Up to 60 requests per minute per key, per endpoint. Exceeding it returns HTTP 429.
Endpoints
/v1/task/createSubmit card content to create a checking task. Consumes points, the same as the web UI.
Body Parameters
content | string · required | Card content, one card per line. Fields are auto-detected; any separator works. |
channel_id | number · required | Channel to run on. Fetch available channels via GET /user/channel. |
pause_until_live_count | number | Auto-pause after N live hits. 0 = no auto-pause (default). |
Example Request
curl -X POST "https://t0check.co/api/v1/task/create" \
-H "X-API-Key: t0_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "content": "4111111111111111|12|2026|123", "channel_id": 1, "pause_until_live_count": 0 }'Example Response
{
"code": 0,
"message": "success",
"data": {
"task_id": "T-20261108-ABCD",
"task_total": 2,
"identify_errors": [
{ "line_number": 3, "card": "not-a-card", "errors": ["Invalid Format"] }
],
"duplicates": [
["4111111111111111|12|2026|123", "Duplicate in input"]
],
"invalid_cards": [
{ "card": "4111111111111111|13|2026|123", "error": "Invalid Expire Length" }
]
}
}/v1/task/{task_id}Fetch a single task by its display ID (the task_id returned on creation).
Example Request
curl -X GET "https://t0check.co/api/v1/task/{task_id}" \
-H "X-API-Key: t0_your_api_key"Example Response
{
"code": 0,
"message": "success",
"data": {
"id": "T-20261108-ABCD",
"total_count": 100,
"live_count": 12,
"dead_count": 83,
"error_count": 5,
"cost": 100,
"pause_until_live_count": 0,
"create_at": 1762560000,
"status": "PROCESSING"
}
}/v1/task/{task_id}/contentPaginate the result rows of a task, with optional status / result filters. All parameters go in the query string — this endpoint used to take a JSON body over POST, so scripts still POSTing to it must switch to GET.
Query Parameters
page | number · required | Page number, starting at 1. |
page_size | number · required | Rows per page. |
result | string | Filter by result: LIVE | DEAD | ERROR. |
status | string | Filter by status: PENDING | PROCESSING | COMPLETED | SUSPENDED. |
is_monitor | boolean | Monitor view flag. Default false. |
Example Request
curl -X GET "https://t0check.co/api/v1/task/{task_id}/content?page=1&page_size=20&result=LIVE" \
-H "X-API-Key: t0_your_api_key"Example Response
{
"code": 0,
"message": "success",
"data": {
"total": 100,
"progressing_count": -1,
"items": [
{
"id": 10234,
"card": "4111111111111111|12|2026|123",
"status": "COMPLETED",
"result": "LIVE",
"reason": "Approved",
"create_at": 1762560000,
"update_at": 1762560120
}
]
}
}/v1/task/{task_id}/statusSend "SUSPENDED" to pause or "PROCESSING" to resume. Completed tasks cannot be changed.
Body Parameters
status | string · required | Target status: SUSPENDED (pause) or PROCESSING (resume). |
Example Request
curl -X POST "https://t0check.co/api/v1/task/{task_id}/status" \
-H "X-API-Key: t0_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "status": "SUSPENDED" }'Example Response
{
"code": 0,
"message": "success"
}/v1/task/{task_id}Delete a task and its contents. This cannot be undone.
Example Request
curl -X DELETE "https://t0check.co/api/v1/task/{task_id}" \
-H "X-API-Key: t0_your_api_key"Example Response
{
"code": 0,
"message": "success"
}