Skip to main content
Reference for all sandbox test data returned by the deepidv API when using a sandbox API key. See Sandbox Mode for setup instructions.

How Sandbox Responses Work

When you make a GET request with a sandbox API key, the API returns pre-built test data instead of querying real records. The response shape is identical to production β€” the only difference is that the data is synthetic. Non-GET requests (POST, PATCH, PUT, DELETE) return a 403 error:

Sessions

Retrieve Session β€” GET /v1/sessions/:id

Use well-known test IDs to control the scenario. Any unrecognized ID returns a random scenario.

test_verified β€” Full β€œeverything” response

Returns a VERIFIED session with every possible field populated. Use this to validate your integration handles the complete response shape. Key fields included:
  • type: "session" (workflow-based)
  • workflow_id, workflow_steps (all 11 steps)
  • bank_statement_request_id
  • location, submitted_at, meta_data
  • Full uploads (primary, secondary, and tertiary IDs, selfies, custom prompt)
  • Complete analysis_data with all sub-objects
  • user (applicant profile) and sender_user (session creator profile)
Analysis data includes:

test_rejected

Returns a REJECTED session with basic analysis data β€” failing face match and ID checks.

test_submitted

Returns a SUBMITTED session with basic analysis data β€” passing scores, awaiting manual review.

test_pending

Returns a PENDING session with no analysis data and session_progress: "PENDING".

test_voided

Returns a VOIDED session with no analysis data.

List Sessions β€” GET /v1/sessions

Returns 5 sessions (one per status) with lightweight analysis data. The list uses basic analysis β€” the full β€œeverything” payload is only returned when fetching test_verified by ID.

Financial

Retrieve Bank Statement β€” GET /v1/financial/:id

test_completed

Returns a completed bank statement with full statement data including accounts, transactions, and holder info.
Sensitive fields (TransitNumber, InstitutionNumber) are omitted from sandbox responses, matching production behavior.

test_pending

Returns a pending bank statement with no statement field.

List Bank Statements β€” GET /v1/financial

Returns 2 bank statements (completed and pending) without the statement body β€” matching production list behavior.

Workflows

Retrieve Workflow β€” GET /v1/workflows/:id

test_workflow β€” Full workflow

Returns a workflow with all 11 available steps, each with realistic config objects:

Any other ID β€” Basic workflow

Returns a workflow with 2 steps: id-verification and face-liveness.

List Workflows β€” GET /v1/workflows

Returns 2 workflows (summary only):