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"
}
]
}
Business Verification (v2)
List Verification Submissions
The KYB verification submission history for a profile, with machine-readable verdicts.
GET
/
v2
/
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.
Only the machine-readable verdict is exposed: the
decision enum and the resulting profile verificationStatus. Free-form explanatory text is not returned.Path Parameters
string
required
The id of the business profile.
Response Fields
array
Submission records, newest first.
Show submission
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. |
Next Steps
Correct and resubmit
Fix the identity and re-run KYB.
Status webhooks
Get the verdict pushed to you.