Skip to main content
The Credit API provides programmatic access to Circle Mint’s credit products. You can initiate draws, track transfer status, manage fees, and process repayments through a dedicated set of endpoints under /v1/credit/.
The Credit API is available to institutional Circle Mint customers with an approved credit facility. A separate offline credit contract through Circle is required before you can access these endpoints.Contact Circle to learn more about credit products.

​
Credit products

Settlement Advance

Bridges settlement timing gaps through a reserve-then-request flow. You reserve funds, upload wire proof, and wait for Treasury approval before disbursement.

Line of Credit

Provides single-request draws with auto-approval and asynchronous disbursement. No wire proof required. Supports crypto repayment directly from your Circle Mint wallet.

​
Key concepts

  • Credit line: Your facility object, including credit limit, used and available amounts, fee rates, minimum balance requirement, and validation errors. Each customer has one credit line.
  • Credit transfers: Individual draw requests against your credit line. Settlement Advance transfers progress through funds_reserved, requested, disbursed, and paid. Line of Credit transfers progress through requested, disbursed, and paid. Both can reach past_due if unpaid after the due date. Transfers on daily cadence have a 7-day repayment due date from disbursement, and transfers on hourly cadence have a 24-hour repayment due date from disbursement.
  • Fees: Each draw can include two types of fees: a draw fee (Settlement Advance only) charged at disbursement and a recurring fee accrued on a cadence determined by your credit line’s feeCadence setting: daily (every 24 hours) or hourly (every hour). The recurringFee rate in feeRates applies at whichever cadence your credit line uses. Hourly cadence is available only on Line of Credit. Fees are auto-deducted from your Circle Mint wallet balance.
  • Minimum balance: A required USDC balance (minBalance) that you must maintain in your Circle Mint wallet while you have an active credit line.
  • Validation errors: Conditions that block new transfer creation, such as INSUFFICIENT_BALANCE, PENDING_FEES, or OVERDUE_TRANSFERS. Returned in the credit line response so you can resolve them before initiating a draw.
  • Blockchain destination: An optional feature that sends disbursed funds directly to a verified blockchain address instead of your Circle Mint wallet. Include the destination field when creating a transfer, referencing an address from your Circle Mint recipient address book. If omitted, funds are deposited into your Circle Mint wallet by default. To manage verified recipient addresses, use the recipient address endpoints.

​
Get started

Quickstart: Settlement Advance

Reserve funds, upload wire proof, and track your advance through disbursement

Quickstart: Line of Credit

Request a draw, monitor its status, and repay using crypto