TrueCheck
Documentation

API Reference

Complete endpoint documentation with request and response schemas for the TrueCheck verification API.

Base URL
https://api.truecheck.co/v1
Authentication

Bearer token auth

All API requests must include your API key in the Authorization header. You can find your API keys in the Dashboard.

Authorization: Bearer sk_live_your_api_key_here

Use sk_test_ prefixed keys for sandbox testing and sk_live_ for production.

Endpoints

Available endpoints

POST/verify/send

Send an SMS verification code to a phone number. Returns a verification object with a unique ID for tracking.

Example Request
curl -X POST https://api.truecheck.co/v1/verify/send \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+15551234567",
    "channel": "sms",
    "locale": "en"
  }'
Example Response
{
  "id": "VE1a2b3c4d5e6f",
  "status": "pending",
  "phone": "+15551234567",
  "channel": "sms",
  "expires_at": "2026-03-13T12:10:00Z",
  "created_at": "2026-03-13T12:00:00Z"
}
POST/verify/check

Verify a code submitted by the user. Returns the verification status and whether the code was correct.

Example Request
curl -X POST https://api.truecheck.co/v1/verify/check \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "verification_id": "VE1a2b3c4d5e6f",
    "code": "482913"
  }'
Example Response
{
  "id": "VE1a2b3c4d5e6f",
  "status": "approved",
  "valid": true,
  "checked_at": "2026-03-13T12:01:32Z"
}
GET/verify/status/{id}

Retrieve the current status of a verification. Useful for polling or checking expiration.

Example Request
curl https://api.truecheck.co/v1/verify/status/VE1a2b3c4d5e6f \
  -H "Authorization: Bearer sk_live_..."
Example Response
{
  "id": "VE1a2b3c4d5e6f",
  "status": "approved",
  "phone": "+15551234567",
  "channel": "sms",
  "attempts": 1,
  "max_attempts": 5,
  "expires_at": "2026-03-13T12:10:00Z",
  "created_at": "2026-03-13T12:00:00Z"
}
GET/lookup/{phone}

Get carrier, line type, and fraud risk data for any phone number. Supports international formats.

Example Request
curl https://api.truecheck.co/v1/lookup/+15551234567 \
  -H "Authorization: Bearer sk_live_..."
Example Response
{
  "phone": "+15551234567",
  "country_code": "US",
  "carrier": "Verizon Wireless",
  "line_type": "mobile",
  "fraud_score": 12,
  "valid": true,
  "ported": false
}

Need help integrating?

Our engineering team is available to help you get set up. Reach out anytime.

Get API KeysContact Support