API Documentation

A simple HTTP API to create and manage checking tasks programmatically.

Base URL

https://t0check.co/api

Authentication

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

POST/v1/task/create

Submit card content to create a checking task. Consumes points, the same as the web UI.

Body Parameters

contentstring · requiredCard content, one card per line. Fields are auto-detected; any separator works.
channel_idnumber · requiredChannel to run on. Fetch available channels via GET /user/channel.
pause_until_live_countnumberAuto-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" }
    ]
  }
}
GET/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"
  }
}
GET/v1/task/{task_id}/content

Paginate 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

pagenumber · requiredPage number, starting at 1.
page_sizenumber · requiredRows per page.
resultstringFilter by result: LIVE | DEAD | ERROR.
statusstringFilter by status: PENDING | PROCESSING | COMPLETED | SUSPENDED.
is_monitorbooleanMonitor 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
      }
    ]
  }
}
POST/v1/task/{task_id}/status

Send "SUSPENDED" to pause or "PROCESSING" to resume. Completed tasks cannot be changed.

Body Parameters

statusstring · requiredTarget 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"
}
DELETE/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"
}