> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Verification Submissions

> The KYB verification submission history for a profile, with machine-readable verdicts.

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.

<Note>
  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`.
</Note>

## Path Parameters

<ParamField path="profile_id" type="string" required>
  The id of the business profile.
</ParamField>

## Response Fields

<ResponseField name="submissions" type="array">
  Submission records, newest first.

  <Expandable title="submission">
    <ResponseField name="id" type="string">Submission id.</ResponseField>
    <ResponseField name="status" type="string">Pipeline status: `submitted`, `processing`, `succeeded`, `failed`, `error`, `timeout`.</ResponseField>
    <ResponseField name="decision" type="string">The verdict: `auto_approve`, `name_confirm_required`, `admin_review`, `reject`, `hold`, or `pending`.</ResponseField>
    <ResponseField name="endpoint" type="string">The verification method used: `tin_match` (US), `kyb_business` / `kyb_ca` (registry search), or a sanctions endpoint.</ResponseField>
    <ResponseField name="matchScore" type="number">Identity match score (0–100), when scored.</ResponseField>
    <ResponseField name="createdAt" type="string">When the submission was created.</ResponseField>
    <ResponseField name="updatedAt" type="string">Last update.</ResponseField>
    <ResponseField name="receivedAt" type="string">When the provider verdict landed, if it has.</ResponseField>
  </Expandable>
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300/submissions" \
    -H "X-Api-Key: trk_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

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

## Next Steps

<CardGroup cols={2}>
  <Card title="Correct and resubmit" icon="pen" href="/api-reference/v2/business-profiles/update-profile">
    Fix the identity and re-run KYB.
  </Card>

  <Card title="Status webhooks" icon="shield-check" href="/api-reference/v2/webhooks/signing">
    Get the verdict pushed to you.
  </Card>
</CardGroup>