deposits

Get a Deposit

Get a deposit by its unique identifier.

get/v1/deposits/{id}

Path parameters

idstring required

The unique identifier for the deposit

Response

The deposit was retrieved

idstring required

The unique identifier for this object.

payment_source_idstring required

The unique identifier for the payment source that contains the money for the deposit.

settled_atstring date-time

The date and time when the deposit was settled.

returned_atstring date-time

The date and time when the deposit was returned.

status'pending' | 'complete' | 'failed' required

The status of the deposit.

created_atstring date-time required

The date and time when the deposit was created.

updated_atstring date-time required

The date and time when the deposit was last updated.

bank_created_atstring date-time

The date and time when the bank created the deposit.

Example response

{
  "id": "deposit_01j8rs605a4gctmbm58d87mvsj",
  "payment_source_id": "payment_source_01j8rs605a4gctmbm58d87mvsj",
  "settled_at": "2020-01-31T23:59:59Z",
  "returned_at": "2020-01-31T23:59:59Z",
  "status": "complete",
  "transfer": {
    "amount": 10000,
    "currency": "USD",
    "financial_account_id": "fa_01j8rs605a4gctmbm58d87mvsj",
    "description": "Disbursement to nonprofit",
    "inbound_account_transfer": {
      "created_at": "2020-01-31T23:00:00Z"
    },
    "inbound_ach_transfer": {
      "standard_entry_class_code": "WEB",
      "company_entry_description": "GRANTPMT",
      "originator_routing_number": "1234567890",
      "originator_company_name": "Charity Good",
      "trace_number": "1234567890",
      "effective_date": "2020-01-31T00:00:00Z",
      "status": "accepted",
      "company_discretionary_data": "GRANT-2024-001"
    },
    "ach_transfer": {
      "transfer_id": "ach_transfer_01j8rs605a4gctmbm58d87mvsj",
      "amount": 10000,
      "status": "initiated",
      "direction": "credit",
      "standard_entry_class_code": "corporate_credit_or_debit",
      "company_entry_description": "Disbursement to nonprofit",
      "trace_number": "012345678901234",
      "effective_date": "2020-01-31T00:00:00Z",
      "submitted_at": "2020-01-31T23:00:00Z",
      "settled_at": "2020-07-12 15:00:00.000",
      "rejected_at": "2020-07-12 15:00:00.000",
      "returned_at": "2020-07-12 15:00:00.000",
      "created_at": "2020-01-31T23:00:00Z",
      "updated_at": "2020-01-31T23:00:00Z"
    },
    "check_deposit": {
      "auxiliary_on_us": "102",
      "routing_number": "101050001",
      "submitted_at": "2020-01-31T23:00:00Z",
      "status": "deposited"
    },
    "inbound_real_time_payments_transfer": {
      "status": "confirmed",
      "debtor_name": "Charity Good",
      "debtor_routing_number": "1234567890",
      "debtor_account_number": "9876543210",
      "transaction_identification": "20240101ABC123",
      "remittance_information": "Grant payment",
      "confirmed_at": "2020-01-31T23:00:00Z"
    },
    "inbound_wire_transfer": {
      "status": "confirmed",
      "originator_name": "Charity Good",
      "originator_routing_number": "1234567890",
      "originator_account_number": "9876543210",
      "confirmed_at": "2020-01-31T23:00:00Z"
    }
  },
  "properties": [
    {
      "property_id": "prop_01j8rs605a4gctmbm58d87mvsj",
      "value": {
        "type": "text"
      }
    }
  ],
  "created_at": "2020-01-31T23:59:59Z",
  "updated_at": "2020-01-31T23:59:59Z",
  "bank_created_at": "2020-01-31T23:59:59Z"
}

Changes

Changed in 6 of the 42 revisions of this API.25550

    • added the optional property transfer/allOf[Transfer]/ach_transfer to the response with the 200 status

      response-optional-property-added

    • added the optional property transfer/allOf[Transfer]/inbound_ach_transfer/allOf[InboundAchTransfer]/company_discretionary_data to the response with the 200 status

      response-optional-property-added

    • added the optional property transfer/allOf[Transfer]/inbound_real_time_payments_transfer to the response with the 200 status

      response-optional-property-added

    • added the optional property transfer/allOf[Transfer]/inbound_wire_transfer to the response with the 200 status

      response-optional-property-added

  • b87f7738d3361025See the full diff
    • removed the required property code from the response with the 400 status

      response-required-property-removed

    • removed the required property code from the response with the 401 status

      response-required-property-removed

    • removed the required property code from the response with the 403 status

      response-required-property-removed

    • removed the required property code from the response with the 404 status

      response-required-property-removed

    • removed the required property code from the response with the 500 status

      response-required-property-removed

    • removed the required property message from the response with the 400 status

      response-required-property-removed

    • removed the required property message from the response with the 401 status

      response-required-property-removed

    • removed the required property message from the response with the 403 status

      response-required-property-removed

    • removed the required property message from the response with the 404 status

      response-required-property-removed

    • removed the required property message from the response with the 500 status

      response-required-property-removed

    • media type application/json was changed to a more specific media type application/problem+json for the response status 400

      response-media-type-name-specialized

    • media type application/json was changed to a more specific media type application/problem+json for the response status 401

      response-media-type-name-specialized

    • media type application/json was changed to a more specific media type application/problem+json for the response status 403

      response-media-type-name-specialized

    • media type application/json was changed to a more specific media type application/problem+json for the response status 404

      response-media-type-name-specialized

    • media type application/json was changed to a more specific media type application/problem+json for the response status 500

      response-media-type-name-specialized

    • added the required property detail to the response with the 400 status

      response-required-property-added

    • added the required property detail to the response with the 401 status

      response-required-property-added

    • added the required property detail to the response with the 403 status

      response-required-property-added

    • added the required property detail to the response with the 404 status

      response-required-property-added

    • added the required property detail to the response with the 500 status

      response-required-property-added

    • added the required property status to the response with the 400 status

      response-required-property-added

    • added the required property status to the response with the 401 status

      response-required-property-added

    • added the required property status to the response with the 403 status

      response-required-property-added

    • added the required property status to the response with the 404 status

      response-required-property-added

    • added the required property status to the response with the 500 status

      response-required-property-added

    • added the required property title to the response with the 400 status

      response-required-property-added

    • added the required property title to the response with the 401 status

      response-required-property-added

    • added the required property title to the response with the 403 status

      response-required-property-added

    • added the required property title to the response with the 404 status

      response-required-property-added

    • added the required property title to the response with the 500 status

      response-required-property-added

    • added the required property type to the response with the 400 status

      response-required-property-added

    • added the required property type to the response with the 401 status

      response-required-property-added

    • added the required property type to the response with the 403 status

      response-required-property-added

    • added the required property type to the response with the 404 status

      response-required-property-added

    • added the required property type to the response with the 500 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the optional property details from the response with the 400 status

      response-optional-property-removed

    • removed the optional property details from the response with the 401 status

      response-optional-property-removed

    • removed the optional property details from the response with the 403 status

      response-optional-property-removed

    • removed the optional property details from the response with the 404 status

      response-optional-property-removed

    • removed the optional property details from the response with the 500 status

      response-optional-property-removed

    • added the optional property details/items/debug to the response with the 400 status

      response-optional-property-added

    • added the optional property details/items/debug to the response with the 401 status

      response-optional-property-added

    • added the optional property details/items/debug to the response with the 403 status

      response-optional-property-added

    • added the optional property details/items/debug to the response with the 404 status

      response-optional-property-added

    • added the optional property details/items/debug to the response with the 500 status

      response-optional-property-added

    • added the optional property details/items/type to the response with the 400 status

      response-optional-property-added

    • added the optional property details/items/type to the response with the 401 status

      response-optional-property-added

    • added the optional property details/items/type to the response with the 403 status

      response-optional-property-added

    • added the optional property details/items/type to the response with the 404 status

      response-optional-property-added

    • added the optional property details/items/type to the response with the 500 status

      response-optional-property-added

    • added the optional property details/items/value to the response with the 400 status

      response-optional-property-added

    • added the optional property details/items/value to the response with the 401 status

      response-optional-property-added

    • added the optional property details/items/value to the response with the 403 status

      response-optional-property-added

    • added the optional property details/items/value to the response with the 404 status

      response-optional-property-added

    • added the optional property details/items/value to the response with the 500 status

      response-optional-property-added

  • 90671617b825155See the full diff
    • the code response's property type/format changed from number/ to string/ for status 400

      response-property-type-changed

    • the code response's property type/format changed from number/ to string/ for status 401

      response-property-type-changed

    • the code response's property type/format changed from number/ to string/ for status 403

      response-property-type-changed

    • the code response's property type/format changed from number/ to string/ for status 404

      response-property-type-changed

    • the code response's property type/format changed from number/ to string/ for status 500

      response-property-type-changed

    • removed the required property error from the response with the 400 status

      response-required-property-removed

    • removed the required property error from the response with the 401 status

      response-required-property-removed

    • removed the required property error from the response with the 403 status

      response-required-property-removed

    • removed the required property error from the response with the 404 status

      response-required-property-removed

    • removed the required property error from the response with the 500 status

      response-required-property-removed

    • removed the required property timestamp from the response with the 400 status

      response-required-property-removed

    • removed the required property timestamp from the response with the 401 status

      response-required-property-removed

    • removed the required property timestamp from the response with the 403 status

      response-required-property-removed

    • removed the required property timestamp from the response with the 404 status

      response-required-property-removed

    • removed the required property timestamp from the response with the 500 status

      response-required-property-removed

    • added the optional property details to the response with the 400 status

      response-optional-property-added

    • added the optional property details to the response with the 401 status

      response-optional-property-added

    • added the optional property details to the response with the 403 status

      response-optional-property-added

    • added the optional property details to the response with the 404 status

      response-optional-property-added

    • added the optional property details to the response with the 500 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property bank_created_at to the response with the 200 status

      response-optional-property-added