api-ninjas-com Routing Number API

openapi: 3.2.0
info:
  title: Ninjas Routing Number API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Routing Number
  description: The Routing Number API allows you to look up bank information using routing numbers. Our database contains over 28,000 routing numbers from banks across the United States.
paths:
  /v1/routingnumber:
    get:
      summary: Get Bank Information by Routing Number
      description: Returns the US bank identified by a routing number. Requires a 9-digit `routing_number`. To find routing numbers by bank name or location instead use /routingnumbersearch.
      operationId: getBankInfo
      tags:
      - Routing Number
      parameters:
      - name: routing_number
        in: query
        description: The 9-digit routing number of the bank to look up.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BankInfo'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
  /v1/routingnumbersearch:
    get:
      summary: Search for Banks and Routing Numbers
      description: Finds US banks and their routing numbers by bank name, city, state, ZIP code or SWIFT/BIC code, with `offset` paging. To decode a known routing number use /routingnumber.
      operationId: searchBanks
      tags:
      - Routing Number
      parameters:
      - name: bank_name
        in: query
        description: Bank name to search for.
        required: false
        schema:
          type: string
      - name: city
        in: query
        description: City name to search for banks.
        required: false
        schema:
          type: string
      - name: state
        in: query
        description: Two-letter state code (e.g. CA, NY).
        required: false
        schema:
          type: string
      - name: zip_code
        in: query
        description: 5-digit ZIP code to search for banks.
        required: false
        schema:
          type: string
      - name: swift_code
        in: query
        description: 8 or 11 character SWIFT/BIC code. Returns the US routing numbers of the bank identified by the code (institution-level match on the first 8 characters). Available for Business and Professional subscribers only.
        required: false
        schema:
          type: string
      - name: offset
        in: query
        description: Number of results to offset for pagination.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BankInfo'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    BankInfo:
      type: object
      properties:
        bank_name:
          type: string
          description: The name of the bank.
        routing_number:
          type: string
          description: The 9-digit routing number of the bank.
        street_address:
          type: string
          description: The street address of the bank.
        city:
          type: string
          description: The city of the bank.
        state:
          type: string
          description: The state of the bank.
        zip_code:
          type: string
          description: The ZIP code of the bank.
        country:
          type: string
          description: The country of the bank.
        county:
          type: string
          description: The county of the bank.
        timezone:
          type: string
          description: The timezone of the bank.
        latitude:
          type: string
          description: The latitude of the bank.
        longitude:
          type: string
          description: The longitude of the bank.
        phone_number:
          type: string
          description: The phone number of the bank.
        swift_code:
          type:
          - string
          - 'null'
          description: The bank's SWIFT/BIC code for international wire transfers. Business tier and above.
        ach_supported:
          type: boolean
          description: Whether the bank processes FedACH (Automated Clearing House) transactions for this routing number. Premium only.
        fedwire_supported:
          type: boolean
          description: Whether the bank supports Fedwire (wire transfer) for this routing number. Premium only.
        checksum_valid:
          type: boolean
          description: Whether the routing number passes ABA routing number checksum validation. Uses the standard Mod 10 checksum algorithm to verify the routing number is structurally valid.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api