Bridge

Bridge Lists API

The Lists API from Bridge — 2 operation(s) for lists.

GitHub OpenAPI

Operations 2

GET /lists/occupation_codes Get occupation codes
GET /lists/countries Get countries

Documentation

📖
APIReference
https://apidocs.bridge.xyz/api-reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bridge/refs/heads/main/openapi/bridge-lists-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bridge-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bridge-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bridge API Keys Lists API
  description: APIs to move into, out of, and between any form of a dollar
  version: '1'
servers:
- url: https://api.bridge.xyz/v0
  description: The base path for all resources
security:
- ApiKey: []
tags:
- name: Lists
paths:
  /lists/occupation_codes:
    get:
      summary: Get occupation codes
      description: 'Provide this list of occupation codes to your users as possible answers to the Source of Funds section in the KYC flow. The returned list will resemble the list of occupation codes found [here](https://apidocs.bridge.xyz/page/sof-eu-most-recent-occupation-list).

        '
      tags:
      - Lists
      responses:
        '200':
          description: The list of occupations that can be used during the KYC flow.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    display_name:
                      type: string
                      example: Accountant and auditor
                      description: Human readable name that customers can select.
                    code:
                      type: string
                      example: '132011'
                      description: The corresponding code that should be sent to the Bridge API representing the customers selection.
              examples:
                OccupationCodesSuccessResponse:
                  $ref: '#/components/examples/OccupationCodesSuccessResponse'
  /lists/countries:
    get:
      summary: Get countries
      description: Returns a list of countries and subdivisions recognized by Bridge. Inclusion in this list does not guarantee Bridge product support for any country or subdivision.
      tags:
      - Lists
      responses:
        '200':
          description: List of supported countries
          content:
            application/json:
              schema:
                title: Countries
                type: object
                required:
                - count
                - data
                properties:
                  count:
                    description: The total number of countries recognized by Bridge
                    type: integer
                  data:
                    type: array
                    description: The list of countries recognized by Bridge
                    minItems: 0
                    items:
                      $ref: '#/components/schemas/Country'
components:
  examples:
    OccupationCodesSuccessResponse:
      summary: The list of occupations that can be used during the KYC flow.
      value:
      - display_name: Accountant and auditor
        code: '132011'
      - display_name: Actor
        code: '272011'
      - display_name: Acupuncturist
        code: '291291'
      - display_name: Administrative services manager
        code: '113012'
      - display_name: Other
        code: other
  schemas:
    Subdivision:
      required:
      - name
      - code
      properties:
        name:
          description: The name of the subdivision
          type: string
          minLength: 1
        code:
          description: The subdivision code, which can be used in place of the name when interacting with Bridge via API
          type: string
          minLength: 2
    Country:
      required:
      - name
      - alpha3
      - subdivisions
      properties:
        name:
          description: The name of the country
          type: string
          minLength: 1
        alpha3:
          description: The three-letter alpha-3 country code as defined in the ISO 3166-1 spec, used in Bridge APIs
          type: string
          minLength: 3
          maxLength: 3
        postal_code_format:
          description: A [Ruby-formatted regular expression](https://ruby-doc.org/3.4.2/Regexp.html) that matches valid postal codes for the country, or null if the country does not use postal codes.
          type: string
          minLength: 1
        subdivisions:
          description: A list of subdivisions for the country
          type: array
          minItems: 0
          items:
            $ref: '#/components/schemas/Subdivision'
  securitySchemes:
    ApiKey:
      type: apiKey
      name: Api-Key
      in: header