Deposits

Request funding instructions for platform-managed accounts from external sources. A given account may have many deposits associated with it depending on the supported rails and configurations.

Endpoints

POST /deposits Create deposit POST /deposits/{id}/accept Accept deposit GET /deposits/{id} Retrieve deposit
POST /deposits

Create a deposit request to receive funds into a platform account.

Request Body

Field Type Description
account_id required string Destination account ID
counterparty_id required string Source counterparty ID
amount required string Deposit amount
rail string Payment rail (ACH, WIRE, FPS, SEPA)
reference string Optional reference for the deposit

Example Request

Request 
{
  "account_id": "acc_123456789",
  "counterparty_id": "cpty_111222333",
  "amount": "5000.00",
  "rail": "ACH",
  "reference": "Invoice #12345"
}

Response

201 Created 
{
  "id": "dep_999888777",
  "account_id": "acc_123456789",
  "counterparty_id": "cpty_111222333",
  "amount": "5000.00",
  "currency": "USD",
  "rail": "ACH",
  "status": "REQUESTED",
  "reference": "Invoice #12345",
  "created_at": "2026-01-15T10:30:00Z"
}
POST /deposits/{id}/accept

Accept a deposit request and receive funding instructions.

Path Parameters

Parameter Type Description
id required string The deposit ID

Response

200 OK 
{
  "id": "dep_999888777",
  "status": "ACCEPTED",
  "funding_instructions": {
    "account_number": "9876543210",
    "routing_number": "021000021",
    "bank_name": "Bultra Bank",
    "bank_address": {
      "line1": "100 Financial Center",
      "city": "New York",
      "state": "NY",
      "postal_code": "10004",
      "country": "US"
    },
    "reference": "DEP999888777",
    "beneficiary_name": "Bultra Inc FBO Customer"
  },
  "expires_at": "2026-01-22T10:30:00Z"
}
GET /deposits/{id}

Retrieve details of a specific deposit.

Response

200 OK 
{
  "id": "dep_999888777",
  "account_id": "acc_123456789",
  "counterparty_id": "cpty_111222333",
  "amount": "5000.00",
  "currency": "USD",
  "rail": "ACH",
  "status": "EXECUTED",
  "reference": "Invoice #12345",
  "funding_instructions": {
    "account_number": "9876543210",
    "routing_number": "021000021",
    "bank_name": "Bultra Bank",
    "reference": "DEP999888777"
  },
  "created_at": "2026-01-15T10:30:00Z",
  "accepted_at": "2026-01-15T10:35:00Z",
  "executed_at": "2026-01-17T14:20:00Z"
}

Deposit Status Values

Status Description
REQUESTED Deposit created, awaiting acceptance
ACCEPTED Deposit accepted, funding instructions available
IN_PROGRESS Funds in transit
EXECUTED Deposit completed successfully
FAILED Deposit failed
CANCELLED Deposit was cancelled