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/bitrefill:bitrefill-discovery-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:
  title: Bitrefill x402 Discovery API
  description: Buy gift cards, eSIMs, mobile top-ups and prepaid cards with USDC via x402. 10,000+ brands across 180+ countries. No API keys or Bitrefill account required — wallet payment and optional SIWX sign-in only.
  version: 1.0.0
  contact:
    name: Bitrefill
    email: miguelmorales@bitrefill.com
  x-guidance: 'Agent checkout flow: search (gift-cards/esims/topups) → GET /x402/products/detail?slug=… → POST /x402/invoice/create with items → POST /x402/invoice/pay with invoice_id → GET /x402/invoice/status?invoice_id=… (SIWX with the paying wallet to retrieve codes). Pay each micro-fee via x402 (PAYMENT-SIGNATURE header) or mint a session at POST /x402/connect (SIGN-IN-WITH-X) and send X-Access-Token on later calls. Full guide: bitrefill.com/agents/SKILL.md'
servers:
- url: https://api.bitrefill.com
tags:
- name: Discovery
  description: Search and browse the catalog (micro-fee per call).
paths:
  /x402/checkout/info:
    get:
      operationId: getCheckoutInfo
      summary: x402 storefront catalog and route map
      description: Entry point listing supported networks, all x402 routes, and wallet-persistence rules.
      tags:
      - Discovery
      parameters:
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        description: x402 payment payload (base64). Required to settle a 402 challenge. v1 clients may send x-payment instead.
        schema:
          type: string
      - name: X-Access-Token
        in: header
        required: false
        description: Session JWT from POST /x402/connect. Bypasses micro-fees and SIWX re-signing until expiry.
        schema:
          type: string
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Route catalog with next_step pointing at gift-card search.
        '402':
          description: Payment Required — x402 payment requirements in the PAYMENT-REQUIRED response header (and mirrored in the JSON body).
        '500':
          description: Unexpected server error.
  /x402/gift-cards/search:
    get:
      operationId: searchGiftCards
      summary: Search gift card products
      description: Search gift cards by query and optional country. Returns product slugs for product detail.
      tags:
      - Discovery
      parameters:
      - name: q
        in: query
        required: false
        description: Search query. Defaults to * (browse) when omitted.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: ISO 3166-1 alpha-2 country code to narrow results (e.g. US).
        schema:
          type: string
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        description: x402 payment payload (base64). Required to settle a 402 challenge. v1 clients may send x-payment instead.
        schema:
          type: string
      - name: X-Access-Token
        in: header
        required: false
        description: Session JWT from POST /x402/connect. Bypasses micro-fees and SIWX re-signing until expiry.
        schema:
          type: string
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Matching products with next_step to GET /x402/products/detail.
        '402':
          description: Payment Required — x402 payment requirements in the PAYMENT-REQUIRED response header (and mirrored in the JSON body).
        '500':
          description: Unexpected server error.
  /x402/esims/search:
    get:
      operationId: searchEsims
      summary: Search eSIM data plans
      description: Search eSIM products by query and optional region/country.
      tags:
      - Discovery
      parameters:
      - name: q
        in: query
        required: false
        description: Search query. Defaults to * (browse) when omitted.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: ISO 3166-1 alpha-2 country code to narrow results (e.g. US).
        schema:
          type: string
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        description: x402 payment payload (base64). Required to settle a 402 challenge. v1 clients may send x-payment instead.
        schema:
          type: string
      - name: X-Access-Token
        in: header
        required: false
        description: Session JWT from POST /x402/connect. Bypasses micro-fees and SIWX re-signing until expiry.
        schema:
          type: string
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Matching eSIM products with next_step to GET /x402/products/detail.
        '402':
          description: Payment Required — x402 payment requirements in the PAYMENT-REQUIRED response header (and mirrored in the JSON body).
        '500':
          description: Unexpected server error.
  /x402/topups/search:
    get:
      operationId: searchTopups
      summary: Search mobile top-up operators
      description: Search prepaid mobile refill operators by query and optional country.
      tags:
      - Discovery
      parameters:
      - name: q
        in: query
        required: false
        description: Search query. Defaults to * (browse) when omitted.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: ISO 3166-1 alpha-2 country code to narrow results (e.g. US).
        schema:
          type: string
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        description: x402 payment payload (base64). Required to settle a 402 challenge. v1 clients may send x-payment instead.
        schema:
          type: string
      - name: X-Access-Token
        in: header
        required: false
        description: Session JWT from POST /x402/connect. Bypasses micro-fees and SIWX re-signing until expiry.
        schema:
          type: string
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Matching top-up products with next_step to GET /x402/products/detail.
        '402':
          description: Payment Required — x402 payment requirements in the PAYMENT-REQUIRED response header (and mirrored in the JSON body).
        '500':
          description: Unexpected server error.