---
title: "Draw principal from a debt line via payout instructions"
method: POST
path: "/debt-lines/{id}/draw"
tags: ["Debt Lines"]
---

# Draw principal from a debt line via payout instructions

`POST /debt-lines/{id}/draw`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/debt-lines/{id}/draw`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/debt-lines/:id/draw/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: An object id with prefix

## Headers

- `Idempotency-Key` string: A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 256 bytes. See [Idempotent Requests](/docs/idempotent-requests).

## Request body

- object
  - `amount` integer, required: amount of principal to draw and send to the originator via payout instructions
  - `description` string, required: description of the transaction
  - `metadata` object: optional metadata to store on the ledger transaction

## Response `200`

Successful operation

- object
  - `description` string, required: Non-empty text string
  - `type` 'draw' | 'pledge' | 'pay' | 'due' | 'transfer' | 'fee' | 'adjustment' | 'reversal' | 'deposit' | 'withdraw', required
  - `date` string, date, required: [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (YYYY-MM-DD). See [Dates and Times](/docs/dates-and-times).
  - `ledger_entries` object[], required: The ledger entries associated with this transaction
    - `account_id` string, required: The id of the ledger associated with this entry
    - `date` string, date, required: Date on which the transaction was settled or canceled. While the transaction is pending this is set to the creation date
    - `amount` number, required: Amount of this ledger entry
    - `id` string, required: An object id with prefix
    - `created_at` string, date-time, required: Creation date and time
    - `created_by` string, required: ID of the user that created this object
    - `updated_at` string, date-time, required: Last update date and time
    - `updated_by` string, required: ID of the user that last updated this object
  - `status` 'pending' | 'settled' | 'canceled', required: The status of the transaction
  - `settled_at` string, date-time: Date and time on which the transaction was settled
  - `internal` object: Internal system data for the transaction
  - `id` string, required: An object id with prefix
  - `created_at` string, date-time, required: Creation date and time
  - `created_by` string, required: ID of the user that created this object
  - `updated_at` string, date-time, required: Last update date and time
  - `updated_by` string, required: ID of the user that last updated this object

## Changes

- **2026-11-03** `4bbab9699612`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/debt-lines/:id/draw/post.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)