CHchariot-giving
deposit_addresses

Create a Deposit Address

Changed on

Provisions a new deposit address on your account. Chariot mints the underlying account and routing numbers and returns them on the response.

An address is unique per (source_id, type). Provisioning a second address for the same source and rail returns 409 Conflict.

If your organization has no open Processing account, the request returns 400 Bad Request.

post/v1/deposit_addresses

Request

  • Base URL
    https://sandboxapi.givechariot.com
  • URL
    https://sandboxapi.givechariot.com/v1/deposit_addresses
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

The idempotency key for the request.

Request body

type'ach' required

The rail this address should receive money over.

source_idstring required

The identifier of the Source this address belongs to.

Example request

{
  "type": "ach",
  "source_id": "source_01m12tn300eh20gdqscje7s5jw"
}

Response

The deposit address was created.

idstring required

The unique identifier for the deposit address.

type'ach' required

The rail this address receives money over. Determines which per-rail subobject is populated on the response.

source_idstring required

The identifier of the Source this address belongs to.

created_atstring date-time required

When this deposit address was provisioned.

Example response

{
  "id": "deposit_address_01m12tn300eh20gdqscje7s5jw",
  "type": "ach",
  "source_id": "source_01m12tn300eh20gdqscje7s5jw",
  "ach": {
    "account_number": "987654321",
    "routing_number": "101050001"
  },
  "created_at": "2026-09-28T12:34:56Z"
}

Changes

  • 2026-10-0124c792014720Revision changes
    • breaking

      removed the required property from the response with the status

    • info

      added the non-success response with the status