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
Response Fields
Submission records, newest first.
Show submission
Show submission
The verification method used:
tin_match (US), kyb_business / kyb_ca (registry search), or a sanctions endpoint.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.