List Verification Submissions

curl -X GET "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300/submissions" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "submissions": [
    {
      "id": "664b0000000000000000aaaa",
      "status": "succeeded",
      "decision": "reject",
      "endpoint": "tin_match",
      "matchScore": 42.0,
      "createdAt": "2026-07-26T12:05:00Z",
      "updatedAt": "2026-07-26T12:06:00Z",
      "receivedAt": "2026-07-26T12:06:00Z"
    }
  ]
}

GET

business-profiles

{profile_id}

submissions

curl -X GET "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300/submissions" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "submissions": [
    {
      "id": "664b0000000000000000aaaa",
      "status": "succeeded",
      "decision": "reject",
      "endpoint": "tin_match",
      "matchScore": 42.0,
      "createdAt": "2026-07-26T12:05:00Z",
      "updatedAt": "2026-07-26T12:06:00Z",
      "receivedAt": "2026-07-26T12:06:00Z"
    }
  ]
}

Returns the verification submission history for a business profile, newest first. Each entry is one KYB attempt with its machine-readable verdict (status + decision enums + matchScore). Use it to drive a “why was this rejected / what happens next” UI.

Free-form decision reasons, the raw provider payload, and reviewer notes are intentionally not exposed — the contract is the decision verdict enum and the resulting profile verificationStatus.

Path Parameters

string

required

The id of the business profile.

Response Fields

array

Submission records, newest first.

Show submission

string

Submission id.

string

Pipeline status: submitted, processing, succeeded, failed, error, timeout.

string

The verdict: auto_approve, name_confirm_required, admin_review, reject, hold, or pending.

string

The verification method used: tin_match (US), kyb_business / kyb_ca (registry search), or a sanctions endpoint.

number

Identity match score (0–100), when scored.

string

When the submission was created.

string

Last update.

string

When the provider verdict landed, if it has.

Examples

curl -X GET "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300/submissions" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "submissions": [
    {
      "id": "664b0000000000000000aaaa",
      "status": "succeeded",
      "decision": "reject",
      "endpoint": "tin_match",
      "matchScore": 42.0,
      "createdAt": "2026-07-26T12:05:00Z",
      "updatedAt": "2026-07-26T12:06:00Z",
      "receivedAt": "2026-07-26T12:06:00Z"
    }
  ]
}

Error Codes

HTTP Status	Error Code	Description
404	`not_found`	No profile with that id on your account.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

List Verification Submissions

Path Parameters

Response Fields

Examples

Error Codes

Next Steps

Correct and resubmit

Status webhooks

​Path Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Correct and resubmit

Status webhooks

Path Parameters

Response Fields

Examples

Error Codes

Next Steps