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

# Asynchronous jobs

> Distinguish acceptance, progress, partial results, and terminal outcomes.

A successful HTTP response can indicate acceptance rather than completed work. The source contract uses `202` for most long-running commands and `201` for creation of a verification session whose result arrives later.

| Command | Acceptance | Observe the result |
| - | - | - |
| [Start sync](https://docs.amlok.io/api-reference/endpoints/platform/start-connection-sync.md) | 202, sync job | `GET /v1/sync-jobs/{id}`; `sync.completed` or `sync.failed` |
| [Start verification](https://docs.amlok.io/api-reference/endpoints/identity/start-verification.md) | 201, verification | `GET /v1/verifications/{id}`; verification events |
| [Search liens](https://docs.amlok.io/api-reference/endpoints/liens/start-lien-search.md) | 202, search | `GET /v1/lien-searches/{id}`; lien-search events |
| [Upload document](https://docs.amlok.io/api-reference/endpoints/identity/upload-document.md) | 202, document | `GET /v1/documents/{id}`; `document.processed` |
| [Run workflow](https://docs.amlok.io/api-reference/endpoints/operations/start-workflow-run.md) | 202, workflow run | `GET /v1/workflow-runs/{id}`; workflow events |
| [Calculate attributes](https://docs.amlok.io/api-reference/endpoints/risk/calculate-attributes.md) | 202, calculation job | `GET /v1/attribute-calculations/{id}`; `attributes.calculated` |

The event replay command returns a queued replay receipt. Monitor redelivery through your webhook receiver and the delivery controls configured during onboarding.

## Poll safely

Persist the returned resource or job ID. Poll the documented retrieval route with bounded backoff, respect throttling, and stop at the resource's terminal state or your application deadline. A client polling deadline does not cancel server work.

Sync-style jobs use `queued`, `running`, `completed`, `partial`, `failed`, and `cancelled`. Other resources have their own typed states. Do not assume every job uses the same enum or that a generic cancellation command exists.

## Interpret completion

* `partial` means some requested scope remains unavailable. Inspect errors, missing intervals, completed jurisdictions, and missing-field reasons.
* Verification completion means a result is available; it can be declined or require review.
* A completed lien search with no results applies only to the declared completed scope.
* Attribute calculation can complete with individual values marked `unavailable`.
* A completed assessment is not authorization to fund a loan or contact a borrower.
* Account cancellation immediately stops processing, usage deductions, and upcoming top-ups. Pending work is cancelled without a usage debit. Full account closure is at the end of the request month. After that month closes and final information is generated, deletion removes all associated workspace data; there is no public deletion-command API.

Retrieve the authoritative resource after an event. Use `resource_version` to avoid overwriting a newer record with an older delivery. See [webhooks](https://docs.amlok.io/api-reference/webhooks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.