Bags That Pay Entities API

entities

Operations 5

POST /mcp/tools/entities_schema The register's shape, counts and provenance #
POST /mcp/tools/entity_lookup One entity by its register identifier or slug #
POST /mcp/tools/entities_in Every entity in a region, paged #
POST /mcp/tools/entities_export The whole register, in pages (access key required) #

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/bagsthatpay-com:bagsthatpay-com-entities-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.

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

OpenAPI Specification

bagsthatpay-com-entities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bagsthatpay Com Entities API
  version: 1.0.0
  contact:
    name: Bags That Pay
    url: https://bagsthatpay.com/
  termsOfService: https://bagsthatpay.com/terms
  description: 'Operations tagged entities across 2 of this provider''s published API definitions: openapi.json, bagsthatpay-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://bagsthatpay.com
  description: Bags That Pay
tags:
- name: Entities
  description: entities
paths:
  /mcp/tools/entities_schema:
    post:
      operationId: entities_schema
      summary: The register's shape, counts and provenance
      description: 'Which fields the Bags That Pay register register carries and on how many entities, the regions and services, the identifier schemes, and how to cite it. Call this first.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Entities
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/entity_lookup:
    post:
      operationId: entity_lookup
      summary: One entity by its register identifier or slug
      description: 'The Bags That Pay register entry for a firm, by its register identifier (scheme + value, e.g. lei) or by the slug of its page. Exact match; returns the whole record with its page.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Entities
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                scheme:
                  type: string
                  minLength: 2
                  maxLength: 24
                  description: identifier scheme, e.g. lei, fca_frn, tdlr_license
                value:
                  type: string
                  minLength: 1
                  maxLength: 80
                slug:
                  type: string
                  minLength: 1
                  maxLength: 120
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/entities_search:
    post:
      operationId: entities_search
      summary: Search the register
      description: 'Entities of Bags That Pay register whose name, commercial name, website, address or authority contains the query, optionally within a region (id or name) and a service (slug or name). Up to 50 rows.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Entities
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                  maxLength: 120
                region:
                  type: string
                  maxLength: 60
                service:
                  type: string
                  maxLength: 80
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/entities_in:
    post:
      operationId: entities_in
      summary: Every entity in a region, paged
      description: 'The Bags That Pay register entities in one region (a state or a jurisdiction, by id or name), optionally for one service, 50 a page.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Entities
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                region:
                  type: string
                  minLength: 2
                  maxLength: 60
                service:
                  type: string
                  maxLength: 80
                page:
                  type: integer
                  minimum: 1
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 50
              required:
              - region
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/entities_export:
    post:
      operationId: entities_export
      summary: The whole register, in pages (access key required)
      description: 'Every entity of Bags That Pay register, 200 a page, with provenance. Needs an access key (Authorization: Bearer); export pages are metered per key per day. Without a key the answer says how to get one.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Entities
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                page:
                  type: integer
                  minimum: 1
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 200
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema, or no access key was sent (the body says how to get one), or the key's daily export budget is spent.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - accessKey: []
      x-metered: export pages per key per day
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
components:
  securitySchemes:
    accessKey:
      type: http
      scheme: bearer
      description: 'An access key (emk_...): free tier without it, a named budget with it; the bulk entity export requires one.'
externalDocs:
  url: https://bagsthatpay.com/mcp
  description: How these tools work
x-refined-from:
- openapi.json
- bagsthatpay-com-openapi.json