Bombora

Bombora Geographic API

The Geographic API from Bombora — 3 operation(s) for geographic.

GitHub OpenAPI

Operations 3

GET /geographic/country Returns a list of country attributes #
GET /geographic/state Returns a list of state attributes #
GET /geographic/metro-area Returns a list of metropolitan area attributes #

Documentation

📖
Documentation
https://developer.bombora.com/docs/authentication-api/1/overview
📖
Documentation
https://developer.bombora.com/docs/account-list-api/1/overview
📖
Documentation
https://developer.bombora.com/docs/reference-api/1/overview
📖
Documentation
https://developer.bombora.com/docs/digital-audience-api/1/overview
📖
Documentation
https://developer.bombora.com/docs/webhooks-api/1/overview

Specifications

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

Other Resources

🔗
TokenEndpoint
https://developer.bombora.com/docs/authentication-api/1/routes/oauth/token/post
🔗
ActivateEndpoint
https://developer.bombora.com/docs/digital-audience-api/1/routes/%7Bdataexchange%7D/%7BexternalId%7D/%7BpartnerId%7D/activate/put
🔗
DestinationEndpoint
https://developer.bombora.com/docs/webhooks-api/1/routes/destination/%7BdestinationId%7D/put
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/bombora/refs/heads/main/asyncapi/bombora-webhooks.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/bombora-geographic-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

bombora-geographic-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Reference Geographic API
  description: The Reference API is used to retrieve reference data that is used throughout Bombora's APIs.
  version: 1.0.1
servers:
- url: https://api.bombora.com/reference/v1
security:
- bearerAuth: []
tags:
- name: Geographic
paths:
  /geographic/country:
    get:
      tags:
      - Geographic
      summary: Returns a list of country attributes
      description: This endpoint returns a collection of country attributes.
      responses:
        '200':
          description: Success - The response body includes the requested resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  country:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: The name of the country.
                        isoCode:
                          type: string
                          description: The ISO code of the country.
              example:
                country:
                - name: Afghanistan
                  isoCode: AF
                - name: Aland Islands
                  isoCode: AX
                - name: Albania
                  isoCode: AL
                - name: Ecuador
                  isoCode: EC
                - name: Egypt
                  isoCode: EG
                - name: El Salvador
                  isoCode: SV
                - name: Vietnam
                  isoCode: VN
                - name: Wallis And Futuna Islands
                  isoCode: WF
                - name: Western Sahara
                  isoCode: EH
        '400':
          $ref: '#/components/responses/BadRequestError'
        '422':
          $ref: '#/components/responses/UnprocessableEntityError'
      operationId: getGeographicCountry
      x-operation-id-source: derived
  /geographic/state:
    get:
      tags:
      - Geographic
      summary: Returns a list of state attributes
      description: This endpoint returns a collection of state attributes (returned for US and CA only).
      responses:
        '200':
          description: Success - The response body includes the requested resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  state:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: The name of the state.
                        stateCode:
                          type: string
                          description: The 2-letter code of the state.
                        countryIsoCode:
                          type: string
                          description: The ISO code of the country to which the state belongs.
              example:
                state:
                - name: Alabama
                  stateCode: AL
                  countryIsoCode: US
                - name: Alaska
                  stateCode: AK
                  countryIsoCode: US
                - name: Alberta
                  stateCode: AB
                  countryIsoCode: CA
                - name: Manitoba
                  stateCode: MB
                  countryIsoCode: CA
                - name: Maryland
                  stateCode: MD
                  countryIsoCode: US
                - name: Massachusetts
                  stateCode: MA
                  countryIsoCode: US
                - name: Wyoming
                  stateCode: WY
                  countryIsoCode: US
                - name: Yukon
                  stateCode: YT
                  countryIsoCode: CA
        '400':
          $ref: '#/components/responses/BadRequestError'
        '422':
          $ref: '#/components/responses/UnprocessableEntityError'
      operationId: getGeographicState
      x-operation-id-source: derived
  /geographic/metro-area:
    get:
      tags:
      - Geographic
      summary: Returns a list of metropolitan area attributes
      description: This endpoint returns a collection of metropolitan area attributes.
      responses:
        '200':
          description: Success - The response body includes the requested resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metroArea:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: The name of the metropolitan area.
              example:
                metroArea:
                - name: Aba(Ngawa) Tibetan And Qiang Autonomous Prefecture, CN-51
                - name: Abbotsford / Mission, BC
                - name: Abilene / Sweetwater, TX
                - name: Bavaria
                - name: Bayan Nur City, CN-15
                - name: Central / Wales and West, ENG
                - name: Central West, NSW
                - name: Jung-Gu Incheon
                - name: Jung-Gu Seoul
                - name: Jung-Gu Ulsan
                - name: Portland, ME / Auburn, NH
                - name: Portland, OR
                - name: Ziyang, CN-51
                - name: Zunyi, CN-52
        '400':
          $ref: '#/components/responses/BadRequestError'
        '422':
          $ref: '#/components/responses/UnprocessableEntityError'
      operationId: getGeographicMetroArea
      x-operation-id-source: derived
components:
  responses:
    BadRequestError:
      description: The request is syntactically invalid.
    UnprocessableEntityError:
      description: The request body is syntactically correct but semantically incorrect, such as validation errors.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorMessageResponse'
  schemas:
    ErrorMessageResponse:
      type: object
      properties:
        message:
          type:
          - string
          - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT