---
updatedAt: 2026-06-29T20:33:19.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Get list of bank accounts

Get a list of bank account objects. By default, you get 20 results on one page of results. Set `max` in your request to get up to 100 results on one page.

See [Search operations with lists](https://developer.bill.com/docs/search-op-with-lists) in the Guides section for filtering, sorting, and pagination examples.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "BILL v3 API",
    "description": "BILL is a cloud-based financial operations platform for an organization's accounts payable (AP), accounts receivable (AR), and spend & expense (S&E) automation.\n\nThe BILL v3 API gives you access to the same infrastructure that powers the AP, AR, and S&E products. In addition, you can receive real-time event notifications with webhooks.\n\nThe BILL Developer Documentation is available at [developer.bill.com](https://developer.bill.com/docs/home).\n\n## Quickstart\nSign-up and generate a developer key for working with the BILL v3 API. With this key, you can build with the AP, AR, BILL network, and webhook workflows. See [Sandbox API sign up](https://developer.bill.com/docs/api-sandbox-sign-up) for more information.\n\n### Spend & Expense API\nAn API token is required for working with the Spend & Expense API. See [Authentication with Spend & Expense API token](https://developer.bill.com/docs/authentication-with-api-token) for more information.\n\n### BILL v3 API in Postman\nWith this collection, you have access to the BILL v3 API in Postman. When you save your sandbox API credentials as environment variables in Postman, you can simply refer to the variables when you are testing with the BILL v3 API. See [BILL v3 API in Postman](https://developer.bill.com/docs/bill-v3-api-in-postman) for more information.",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://gateway.stage.bill.com/connect",
      "description": "sandbox"
    }
  ],
  "paths": {
    "/v3/funding-accounts/banks": {
      "get": {
        "tags": [
          "funding-accounts"
        ],
        "summary": "Get list of bank accounts",
        "description": "Get a list of bank account objects. By default, you get 20 results on one page of results. Set `max` in your request to get up to 100 results on one page.\n\nSee [Search operations with lists](https://developer.bill.com/docs/search-op-with-lists) in the Guides section for filtering, sorting, and pagination examples.",
        "operationId": "listBankAccounts",
        "parameters": [
          {
            "name": "sessionId",
            "in": "header",
            "schema": {
              "type": "string",
              "description": "API session ID generated with `/v3/login`",
              "nullable": true,
              "example": "{{session_id}}"
            }
          },
          {
            "name": "devKey",
            "in": "header",
            "schema": {
              "type": "string",
              "description": "Developer key generated with your BILL developer account",
              "nullable": true,
              "example": "{{developer_key}}"
            }
          },
          {
            "name": "max",
            "in": "query",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "description": "Maximum number of results",
              "format": "int32",
              "nullable": true,
              "example": 10
            }
          },
          {
            "name": "sort",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Field name and sort order. Both simple and compound sorting is available.\n\nThe format is `sort={field_01}:{sort_order},{field_02}:{sort_order}`.\n\n**NOTE**: Sorting occurs in the specified order.",
              "nullable": true,
              "example": "createdTime:desc"
            }
          },
          {
            "name": "filters",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Field name, operator, and value. Both simple and compound filtering is available.\n\nThe format is `filters={field_01}:{op}:{value},{field_02}:{op}:{value}`.",
              "nullable": true,
              "example": "bankAccountId:eq:{{org_bank_account_id}}"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Next page of results.\n\nWhen a list has multiple pages, the `nextPage` and `prevPage` values in the response enable you to navigate between the pages of results. Set `page` as the `nextPage` or `prevPage` value for navigation.",
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get list of bank accounts response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListOrganizationBankAccountResponseDto"
                }
              }
            }
          },
          "4XX": {
            "description": "List of errors.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BdcError"
                  }
                }
              }
            }
          },
          "5XX": {
            "description": "List of errors.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BdcError"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BankAccountOwnerType": {
        "type": "string",
        "description": "BankAccountOwnerType Enum.",
        "enum": [
          "BUSINESS",
          "PERSONAL"
        ]
      },
      "BankAccountStatus": {
        "type": "string",
        "description": "Bank account status.",
        "enum": [
          "NOT_VERIFIED",
          "VERIFIED",
          "PENDING",
          "BLOCKED",
          "EXPIRED",
          "INVALID",
          "UNDEFINED"
        ]
      },
      "BankAccountType": {
        "type": "string",
        "description": "BankAccountType Enum.",
        "enum": [
          "CHECKING",
          "SAVINGS"
        ]
      },
      "BankAccountVerificationLevel": {
        "type": "string",
        "description": "How strongly the bank account is verified.",
        "enum": [
          "NONE",
          "VERIFIED_FOR_FRAUD_RELAXED",
          "VERIFIED_FOR_FRAUD_STRICT",
          "FULLY_VERIFIED",
          "UNDEFINED"
        ]
      },
      "BdcError": {
        "required": [
          "category",
          "code",
          "severity",
          "timestamp"
        ],
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "code": {
            "type": "string"
          },
          "severity": {
            "$ref": "#/components/schemas/Severity"
          },
          "category": {
            "$ref": "#/components/schemas/Category"
          },
          "message": {
            "type": "string"
          },
          "params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Param"
            }
          },
          "detail": {
            "type": "string"
          },
          "help": {
            "type": "string"
          }
        }
      },
      "Category": {
        "type": "string",
        "enum": [
          "REQUEST",
          "APPLICATION",
          "SERVER",
          "DOWNSTREAM"
        ]
      },
      "ListOrganizationBankAccountResponseDto": {
        "type": "object",
        "description": "Get list of bank accounts response.",
        "allOf": [
          {
            "$ref": "#/components/schemas/ListResponseDto_OrganizationBankAccountResponseDto_"
          },
          {
            "properties": {
              "count": {
                "type": "integer",
                "description": "Total number of bank accounts matching the list request, across all pages of results.",
                "format": "int32"
              }
            }
          }
        ]
      },
      "ListResponseDto_OrganizationBankAccountResponseDto_": {
        "type": "object",
        "properties": {
          "nextPage": {
            "type": "string"
          },
          "prevPage": {
            "type": "string"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrganizationBankAccountResponseDto"
            }
          }
        },
        "description": "Response from a list API request with paging references."
      },
      "OrganizationBankAccountDefault": {
        "type": "object",
        "properties": {
          "payables": {
            "type": "boolean",
            "description": "Set as `true` if the bank account is set as default for Accounts Payable operations"
          },
          "receivables": {
            "type": "boolean",
            "description": "Set as `true` if the bank account is set as default for Accounts Receivable operations"
          }
        },
        "description": "Bank account defaults."
      },
      "OrganizationBankAccountResponseDto": {
        "required": [
          "archived",
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "BILL-generated ID of the bank account. The value begins with `bac`."
          },
          "archived": {
            "type": "boolean",
            "description": "Set as `true` if the bank account is archived"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BankAccountStatus"
              },
              {
                "description": "Bank account status."
              }
            ]
          },
          "verificationLevel": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BankAccountVerificationLevel"
              },
              {
                "description": "How strongly the bank account is verified."
              }
            ]
          },
          "createdBy": {
            "type": "string",
            "description": "BILL-generated ID of the user that created the bank account. The value begins with `006`."
          },
          "routingNumber": {
            "type": "string",
            "description": "Bank routing number"
          },
          "accountNumber": {
            "type": "string",
            "description": "Bank account number"
          },
          "nameOnAccount": {
            "type": "string",
            "description": "Full name on bank account"
          },
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BankAccountType"
              },
              {
                "description": "Bank account type"
              }
            ]
          },
          "ownerType": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BankAccountOwnerType"
              },
              {
                "description": "Bank account owner type"
              }
            ]
          },
          "bankName": {
            "type": "string",
            "description": "Bank name"
          },
          "accessToAdmins": {
            "type": "boolean",
            "description": "Set as `true` to enable access to all users with the `ADMINISTRATOR` user role"
          },
          "default": {
            "allOf": [
              {
                "$ref": "#/components/schemas/OrganizationBankAccountDefault"
              },
              {
                "description": "Bank account default values for BILL AP and AR operations"
              }
            ]
          },
          "createdTime": {
            "type": "string",
            "description": "Created date and time",
            "format": "date-time"
          },
          "updatedTime": {
            "type": "string",
            "description": "Updated date and time",
            "format": "date-time"
          },
          "chartOfAccountId": {
            "type": "string",
            "description": "BILL-generated ID of the chart of accounts for the bank account. The value begins with `0ca`."
          }
        },
        "description": "Bank account response."
      },
      "Param": {
        "required": [
          "name",
          "value"
        ],
        "type": "object",
        "properties": {
          "additional": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "name": {
            "minLength": 1,
            "type": "string"
          },
          "value": {
            "minLength": 1,
            "type": "string"
          }
        }
      },
      "Severity": {
        "type": "string",
        "enum": [
          "ERROR",
          "WARNING",
          "INFORMATION"
        ]
      }
    }
  }
}
```