Get Check Deposit Bank Accounts

GET

/inboxes/{inbox_id}/check-deposit-bank-accounts

Returns the bank accounts checks from this inbox can be deposited to. Use an account’s id as check_deposit_bank_account_id in Request Check Deposit.

Every member of the inbox sees the same accounts. Only inbox admins receive routing_number and the contact_* fields; other callers get the ID, display name, bank, account type and masked account number.

Authorizations

Send your API key in the x-api-key header. See Authentication.

Parameters

Path Parameters

inbox_id

required

string

Query Parameters

page

integer

The desired page from the result set. Defaults to 1.

per_page

integer

The number of items per page. Defaults to 100.

Responses

200

Success

object

total

Total number of items across all pages.

integer

15

per_page

Number of items per page.

integer

100

current_page

The current page number (1-based).

integer

1

last_page

The last available page number.

integer

1

from

The index of the first item on this page (1-based).

integer

1

to

The index of the last item on this page (1-based).

integer

15

data

Array<object>

object

id

integer

created_at

string format: date-time

updated_at

string format: date-time

inbox_id

integer | null

routing_number

string

121000248

check_processing_system_type

integer

account_number

string

********4510

account_display_name

string

Business Checking

account_type

string

checking

financial_institution

object

id

integer

name

string

First National Bank

routing_number

string

has_shipping_address

boolean

shipping_banking_institution_id

integer | null

expedited

When true, every deposit to this bank ships overnight at no extra cost, so there’s no need to request expedited.

boolean

shipping_addresses

Array<object>

object

id

integer

123456

created_at

string format: date-time

updated_at

string format: date-time

addressee

string

Molly Smith

address_line_1

string

1004 S Mt Olive St

address_line_2

string

locality

string

PHOENIX

region_abbreviation

string

AZ

region

string

Arizona

country_abbreviation

string

US

country

string

United States

postal_code

string

72761

phone

string

tags

Array<string>

[
  "domestic"
]

delivery_confidence_percent

number | null

inbox_id

integer | null

company

string | null

is_authorized

boolean | null

requires_hs_tariff_codes

boolean | null

requires_itn

boolean | null

rdc

boolean

rdcVerified

boolean

contact_name

string

contact_business

string

contact_address

string

contact_phone

string

rdc

boolean

Example

{
  "current_page": 1,
  "data": [
    {
      "id": 500,
      "created_at": "2020-04-01T09:00:00Z",
      "updated_at": "2020-04-01T09:00:00Z",
      "inbox_id": 100003,
      "check_processing_system_type": 0,
      "account_number": "********4510",
      "account_display_name": "Business Checking",
      "account_type": "checking",
      "financial_institution": {
        "id": 42,
        "name": "First National Bank",
        "expedited": true
      }
    }
  ],
  "from": 1,
  "last_page": 1,
  "per_page": 100,
  "to": 1,
  "total": 1
}

401

The x-api-key header is missing or the key is not valid, or the caller can’t access an ID in the request. IDs that don’t exist return the same response as IDs the caller can’t access.

Error envelope returned with 4xx and 5xx responses.

object

error

object

code

Usually the HTTP status code. It can differ; a request to an unknown path returns HTTP 400 with code 500.

integer

401

message

Human-readable description of the error.

string

type

The kind of error, for example Authorization or REST.

string

REST

fields

Returned only with 422 responses. It may give more details about what failed validation, as lists of messages keyed by the name of the input.

object

key

additional properties

Array<string>

Examples

{
  "error": {
    "code": 401,
    "message": "The request does not include a valid access token. Please provide a valid access token.",
    "type": "Authorization"
  }
}

{
  "error": {
    "code": 401,
    "message": "x-api-key: x-api-key is invalid",
    "type": "REST"
  }
}

{
  "error": {
    "code": 401,
    "message": "User does not have access to requested resource.",
    "type": "Authorization"
  }
}