> ## Documentation Index
> Fetch the complete documentation index at: https://every.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a vendor's bank account

> Retrieves one of the vendor's bank accounts by its id, together with the bank it is held at.
Deleted accounts are never returned.

The bank fields are read live for the one account, which is why they are served here and not
by `GET /v1/vendors/{vendorId}/bank-accounts`: an `ach` account's come from the bank network
record Every holds for it, a `wire` account's from the wire instructions it was saved with.
They are `null` for a `check` or `international` account, and when they could not be read;
the account itself is returned either way.




## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/vendors/{vendorId}/bank-accounts/{id}
openapi: 3.0.0
info:
  title: Every Public API
  version: 1.0.0
  description: >
    The Every public API. Keys are issued per company and every response is
    scoped to the company

    that owns the calling key.


    Every response carries an `x-request-id` header, generated by Every for that
    request. Quote it

    when contacting support: it is the id the request is recorded under. A
    caller-supplied

    `x-request-id` is never echoed.
servers:
  - url: https://api.public.every.io/company
    description: Production
security:
  - apiKey: []
tags:
  - name: Company
    description: The company the calling key belongs to.
  - name: Vendors
    description: The people and businesses the company pays, and their W9 details.
  - name: Bank accounts
    description: A vendor's accounts at its own bank, the accounts payments are paid into.
  - name: Payments
    description: >-
      ACH payments from the company's Every account to a vendor, and where they
      are.
  - name: Reference data
    description: The categories and departments a payment is filed under.
paths:
  /v1/vendors/{vendorId}/bank-accounts/{id}:
    get:
      tags:
        - Bank accounts
      summary: Get a vendor's bank account
      description: >
        Retrieves one of the vendor's bank accounts by its id, together with the
        bank it is held at.

        Deleted accounts are never returned.


        The bank fields are read live for the one account, which is why they are
        served here and not

        by `GET /v1/vendors/{vendorId}/bank-accounts`: an `ach` account's come
        from the bank network

        record Every holds for it, a `wire` account's from the wire instructions
        it was saved with.

        They are `null` for a `check` or `international` account, and when they
        could not be read;

        the account itself is returned either way.
      operationId: getVendorBankAccountById
      parameters:
        - name: vendorId
          in: path
          description: A vendor of the calling company, the one the account belongs to
          required: true
          schema:
            $ref: '#/components/schemas/Id'
        - name: id
          in: path
          description: The bank account, from `GET /v1/vendors/{vendorId}/bank-accounts`
          required: true
          schema:
            $ref: '#/components/schemas/Id'
      responses:
        '200':
          description: The bank account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankAccountDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: No such bank account on this vendor of the calling company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/UnexpectedError'
components:
  schemas:
    Id:
      type: string
      format: uuid
    BankAccountDetail:
      allOf:
        - $ref: '#/components/schemas/BankAccount'
        - type: object
          required:
            - bank_name
            - routing_number
            - account_number_last4
            - account_type
          properties:
            bank_name:
              description: The name of the bank holding the account
              type: string
              nullable: true
              example: Chase
            routing_number:
              description: The account's ABA routing number
              type: string
              nullable: true
              example: '021000021'
            account_number_last4:
              description: >-
                The last four digits of the account number. The full number is
                never served, for an `ach` or a `wire` account alike: an account
                added outside this API was never disclosed to the caller.
              type: string
              nullable: true
              example: '6789'
            account_type:
              description: >-
                The kind of account at the bank, in lower case: `checking` or
                `savings` for an account created through this API.
              type: string
              nullable: true
              example: checking
    Error:
      type: object
      properties:
        message:
          type: string
        errors:
          type: array
          items:
            type: object
    BankAccount:
      description: >-
        An external bank account of a vendor: the account at the vendor's own
        bank that Every pays it into. Not an Every account of the calling
        company.
      type: object
      required:
        - id
        - vendor_id
        - type
        - is_default
        - created_at
      properties:
        id:
          $ref: '#/components/schemas/Id'
        vendor_id:
          $ref: '#/components/schemas/Id'
        type:
          $ref: '#/components/schemas/BankAccountType'
        is_default:
          description: >-
            Whether the Every dashboard pays this vendor into this account
            unless told otherwise. A payment created through this API always
            names its account.
          type: boolean
        created_at:
          description: The date the account was attached to the vendor
          type: string
          format: date
    BankAccountType:
      description: >-
        The rail the account is paid over. `ach` is the only type an account
        created through this API has, and the only one `POST /v1/payments` can
        pay into; the others appear on accounts added in the Every dashboard.
        The single-account endpoint reports bank fields for `ach` and `wire`
        accounts and `null` for the rest.
      type: string
      enum:
        - ach
        - wire
        - check
        - international
      example: ach
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >-
        The `x-api-key` header is missing, or the key is unknown, revoked, or
        not enabled for this API. The body is `{"message":"Forbidden"}`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnexpectedError:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.