Marqeta

Marqeta Internal - BIN Pools API

The Internal - BIN Pools API from Marqeta — 2 operation(s) for internal - bin pools.

Documentation GitHub OpenAPI

Operations 5

GET /internal/binpools Get all BIN pools #

POST /internal/binpools Create BIN pool #

DELETE /internal/binpools/{token} Delete BIN pool #

GET /internal/binpools/{token} Get BIN pool by token #

PUT /internal/binpools/{token} Update BIN pool #

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/marqeta-internal-bin-pools-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

openapi: 3.2.0
info:
  contact:
    email: support@marqeta.com
    name: Marqeta
  description: Marqeta's Core API endpoints, conveniently annotated to enable code generation (including SDKs), test cases, and documentation. Currently in beta.
  termsOfService: https://www.marqeta.com/api-terms
  title: Core accepted countries Internal - BIN Pools API
  version: 3.0.39
servers:
- url: /v3
security:
- mqAppAndAccessToken: []
tags:
- name: Internal - BIN Pools
paths:
  /internal/binpools:
    get:
      description: Returns a list of all BIN pools
      operationId: getAllPools
      responses:
        default:
          content: {}
          description: successful operation
      summary: Get all BIN pools
      tags:
      - Internal - BIN Pools
    post:
      description: Creates a new BIN pool
      operationId: createPool
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BinPoolCreateRequest'
        description: Create request
        required: true
      responses:
        default:
          content: {}
          description: successful operation
      summary: Create BIN pool
      tags:
      - Internal - BIN Pools
  /internal/binpools/{token}:
    delete:
      description: Soft deletes a BIN pool by setting active=false
      operationId: deletePool
      parameters:
      - description: Pool token
        explode: false
        in: path
        name: token
        required: true
        schema:
          type: string
        style: simple
      responses:
        default:
          content: {}
          description: successful operation
      summary: Delete BIN pool
      tags:
      - Internal - BIN Pools
    get:
      description: Returns details of a specific BIN pool
      operationId: getPool
      parameters:
      - description: Pool token
        explode: false
        in: path
        name: token
        required: true
        schema:
          type: string
        style: simple
      responses:
        default:
          content: {}
          description: successful operation
      summary: Get BIN pool by token
      tags:
      - Internal - BIN Pools
    put:
      description: Updates an existing BIN pool
      operationId: updatePool
      parameters:
      - description: Pool token
        explode: false
        in: path
        name: token
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BinPoolUpdateRequest'
        description: Update request
        required: true
      responses:
        default:
          content: {}
          description: successful operation
      summary: Update BIN pool
      tags:
      - Internal - BIN Pools
components:
  schemas:
    BinPoolCreateRequest:
      description: Request to create a new BIN pool
      properties:
        bin_prefixes:
          description: List of BIN prefixes to add to the pool
          items:
            type: string
          type: array
        config:
          description: JSON configuration object
          example: '{\"reserved_capacity\": 10, \"min_available_bins\": 2}'
          type: string
        description:
          description: Description of the BIN pool
          example: Primary pool for standard Visa cards
          type: string
        name:
          description: Name of the BIN pool
          example: Standard Visa Pool
          type: string
        pool_type:
          description: Type of pool
          enum:
          - STANDARD
          - GOOGLE_VCN
          example: STANDARD
          type: string
        token:
          description: Unique token for the BIN pool
          example: standard-visa-pool-01
          type: string
        usage_type:
          description: BIN selection strategy
          enum:
          - RANDOM
          - LEAST_EXHAUSTED
          - SEQUENTIAL
          example: LEAST_EXHAUSTED
          type: string
      required:
      - name
      - token
      type: object
    BinPoolUpdateRequest:
      description: Request to update a BIN pool
      properties:
        active:
          description: Whether the pool is active
          example: false
          type: boolean
        config:
          description: JSON configuration object
          example: '{\"reserved_capacity\": 20, \"min_available_bins\": 5}'
          type: string
        description:
          description: Description of the BIN pool
          example: Updated description
          type: string
        name:
          description: Name of the BIN pool
          example: Updated Pool Name
          type: string
        usage_type:
          description: BIN selection strategy
          enum:
          - RANDOM
          - LEAST_EXHAUSTED
          - SEQUENTIAL
          example: RANDOM
          type: string
      type: object
  securitySchemes:
    mqAppAndAccessToken:
      scheme: basic
      type: http