healthy journey to explore the full result, then use the other cases to test missing information and recovery.
What each business contains
Completed assessments create risk packages and monitoring records. An Origination that requires a document, requires reauthorization or fails retains that state; it does not invent completed results. Recovery scenarios continue the same workflow after the required action. A cancelled connection scenario intentionally creates no connected sources or document pack.
Understand the figures
The reporting period covers the twelve complete calendar months before the run’s current month, with an exclusive end date. For example, a run in November covers November 1 of the preceding year through November 1 of the current year. Each month has receipts on day 5 and payments on day 20, with daily closing balances between them. Canadian businesses report in CAD; US businesses report in USD. The workspace’s simulated wallet and API consumption remain CAD. Business revenue and financing currency do not change the currency of your AMLOK invoice. For a normal healthy run, bank receipts, paid invoice totals and net commerce sales reconcile. Financial statements include supporting schedules used by the metrics. Amounts are decimal strings; ratios such as"0.20" mean 20%. Evidence references identify the collected record and field used in a calculation. Do not assume all 149 metric keys must be available: consumer-only metrics are not applicable, and unsupported bureau information and calibrated model outputs remain explicitly unavailable.
The data, people, verification results and files are fictional. Identity files are verification reports, not genuine identity documents. A simulated passing check does not establish that any real person, business or document was verified.
Retrieve real document URLs
Document IDs are durable references; download URLs are temporary capabilities. Do not hard-code a URL from a screenshot, example response or previous run. Request a fresh link when the user opens a file and use itsexpires_at value.
- Wait for
GET /v1/sandbox/runs/{id}to returncompleted. - Find resources with
kind: "document", or readdocument_idsfrom the Origination’s submitted request. - Read
GET /v1/documents/{id}and check thatstatusisavailable. - Call
POST /v1/documents/{id}/download-linkswith apurposedescribing the access and a new idempotency key. - Fetch the returned
data.urlwithout forwarding your API key. Check the file’s SHA-256 against the returnedsha256.
AMLOK_DOCUMENT_ID to a document resource ID; keep AMLOK_API_KEY server-side.
Follow the result back to its sources
From a completed Origination, retrieve itsrisk_package_id. Inspect assessment, then a dimension’s metrics. An available metric includes its value, unit, calculation version, assumptions and inputs. Follow the input’s evidence_id and field_path to the source observation; use document_id when a file supports that observation.
Use GET /v1/data/records to inspect normalized integration data and its source envelope. Traverse the returned pagination cursors to retrieve the whole collection. The package also includes financial statements, obligations and repayment schedules, collateral, tax, concentration, reconciliation and deterministic cash projections under analyses. Verification sections include the source report references and missing-field explanations.
The manual_review case deliberately omits the proposed repayment schedule, so DSCR and dependent debt-service metrics remain unavailable. The lending-terms PDF explains that omission. The monitoring_alert case reduces bank receipts while keeping the accounting observations, producing both deterioration and a reconciliation difference. monitoring_recovery restores receipts and reevaluates the monitor.
Refresh samples without losing prior tests
The catalog version identifies the sample release. Fetch it fromGET /v1/sandbox/catalog before starting a new run. Existing runs, documents and risk packages remain unchanged when the sample package is updated. Load six sample businesses or Repeat with fresh records creates new records with the current package; it does not rewrite old results or reset shared credits.
To discard all prior tests and load only a fresh package, an Owner uses Workspaces > Sandbox data > Load fresh sample data. To remove samples and start from your own requests, choose Start empty there. Both are destructive resets; review reset scope and confirmation.
For expected outcomes, permissions and executable commands, see businesses and scenarios and API Sandbox journeys. Use simulated billing to reconcile funding and consumption. Initial sample preparation records events without sending webhooks; explicitly enable delivery to your test receiver when you want real HTTP delivery.