api-ninjas-com Canada Routing Number API

openapi: 3.2.0
info:
  title: Ninjas Canada 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: Canada Routing Number
  description: The Canada Routing Number API allows you to look up Canadian bank information using a routing number, transit number, or institution number. Our database covers every Canadian bank, credit union, and caisse populaire branch, with up-to-date transit and institution data.
paths:
  /v1/canadaroutingnumber:
    get:
      summary: Get Canadian Bank Branch Information by Routing Number
      description: Returns the Canadian bank branch for a 9-digit EFT `routing_number`, or for a `transit_number` plus `institution_number`. To search by name or location use /canadaroutingnumbersearch.
      operationId: getCanadaRoutingNumberInfo
      tags:
      - Canada Routing Number
      parameters:
      - name: routing_number
        in: query
        description: The 9-digit Canadian routing number in EFT format (0AAATTTTT). At least one of routing_number, or both transit_number and institution_number together, must be set.
        required: false
        schema:
          type: string
      - name: transit_number
        in: query
        description: The 5-digit branch transit number. Must be used together with institution_number.
        required: false
        schema:
          type: string
      - name: institution_number
        in: query
        description: The 3-digit financial institution number. Must be used together with transit_number.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CanadaRoutingNumberOpenapi_BranchInfo'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
  /v1/canadaroutingnumbersearch:
    get:
      summary: Search for Canadian Banks and Routing Numbers
      description: Finds Canadian bank branches and their routing numbers by bank name, city, province or postal code. To decode a known routing number use /canadaroutingnumber. Requires a premium subscription.
      operationId: searchCanadaRoutingNumbers
      tags:
      - Canada Routing Number
      parameters:
      - name: bank_name
        in: query
        description: Bank name to search for. At least one of bank_name, city, province, or postal_code is required. Premium only.
        required: false
        schema:
          type: string
      - name: city
        in: query
        description: City name to search for branches. Premium only.
        required: false
        schema:
          type: string
      - name: province
        in: query
        description: Two-letter province or territory code (e.g. ON, QC, BC). Premium only.
        required: false
        schema:
          type: string
      - name: postal_code
        in: query
        description: Postal code to search for branches. Premium only.
        required: false
        schema:
          type: string
      - name: offset
        in: query
        description: Number of results to offset for pagination. Available for annual subscriptions only.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CanadaRoutingNumberOpenapi_BranchInfo'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
components:
  schemas:
    CanadaRoutingNumberOpenapi_BranchInfo:
      type: object
      properties:
        bank_name:
          type:
          - string
          - 'null'
          description: The name of the bank. Premium only.
        routing_number:
          type: string
          description: The 9-digit Canadian routing number in EFT format.
        transit_number:
          type: string
          description: The 5-digit branch transit number.
        institution_number:
          type: string
          description: The 3-digit financial institution number.
        branch_name:
          type:
          - string
          - 'null'
          description: The name of the branch. Premium only.
        street_address:
          type:
          - string
          - 'null'
          description: The street address of the branch. Premium only.
        city:
          type: string
          description: The city of the branch.
        province:
          type: string
          description: The two-letter province or territory code (e.g. ON, QC, BC).
        postal_code:
          type: string
          description: The postal code of the branch.
        country:
          type: string
          description: Always CA.
        swift_code:
          type:
          - string
          - 'null'
          description: The SWIFT/BIC code of the bank, useful for international wire transfers. Premium only.
        checksum_valid:
          type: boolean
          description: Whether the routing number passes structural validation. Canada does not use a checksum algorithm, so this confirms the format is valid (9 digits, leading zero, recognized institution number).
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api