POST /api/sandbox/loans
POST/api/sandbox/loans
Creates a Sandbox loan directly, without the step-by-step cabinet-compatible flow. This endpoint is useful for quick backend tests. To simulate the real borrower dashboard, use POST /api/sandbox/loans/flow.
The request body defines BTC collateral, loan amount, loan currency, and optional partner client identifiers. external_client_id and client_reference help group deals in the admin interface and match them to a client in the partner system.
POST requests must include Idempotency-Key so a retry does not create a second loan.
Request
Responses
- 200
- 400
- 401
- 409
- 429
Sandbox loan created
Invalid request: invalid body, missing Idempotency-Key for POST, unknown action, or invalid amount
Sandbox API key is missing or invalid
The flow cannot continue from the current state, a balance/limit is insufficient, or Idempotency-Key conflicts
Sandbox API rate limit exceeded