Bitrefill | Apiosk Gateway

Method	Path	Description	Cost
GET	/x402/checkout/info	Discover the Bitrefill x402 storefront: supported networks, the full route flow, and wallet persistence rules.	$0.0011 default	View details
GET	/x402/esims/search	Search prepaid eSIM data plans for 180+ countries and regions. Pay in USDC via x402, no account.	$0.0023 default	View details
GET	/x402/gift-cards/search	Search 10,000+ gift card & voucher brands across 180+ countries by name and country. Pay in USDC via x402, no account.	$0.0023 default	View details
GET	/x402/products/detail	Get a product's packages, pricing, and recipient requirements before creating an invoice.	$0.0011 default	View details
GET	/x402/topups/search	Search mobile top-ups & prepaid airtime for carriers in 180+ countries. Pay in USDC via x402, no account.	$0.0023 default	View details

Endpoint documentation

GET/x402/checkout/info

$0.0011 default

Description

Discover the Bitrefill x402 storefront: supported networks, the full route flow, and wallet persistence rules.

Pricing

$0.0011 default

Parameters

{
  "properties": {},
  "type": "object"
}

Example response

{
  "next_step": {
    "url": "/x402/gift-cards/search"
  },
  "routes": [
    {
      "method": "GET",
      "path": "/x402/gift-cards/search",
      "purpose": "Search gift card products by query and country."
    }
  ],
  "service": "Bitrefill x402 storefront",
  "supported_networks": [
    "eip155:8453",
    "solana:mainnet"
  ],
  "wallet_persistence": "Codes and eSIMs are bound to the paying wallet; recovery and top-ups require the same wallet"
}

GET/x402/esims/search

$0.0023 default

Description

Search prepaid eSIM data plans for 180+ countries and regions. Pay in USDC via x402, no account.

Pricing

$0.0023 default

Parameters

{
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)",
      "type": "string"
    },
    "q": {
      "description": "Search query (region or country name)",
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "next_step": {
    "body": {
      "slug": "<product slug from results>"
    },
    "url": "/x402/products/detail"
  },
  "products": [
    {
      "in_stock": true,
      "name": "Europe eSIM",
      "recipient_type": "none",
      "region": "EU",
      "slug": "esim-europe"
    }
  ]
}

GET/x402/gift-cards/search

$0.0023 default

Description

Search 10,000+ gift card & voucher brands across 180+ countries by name and country. Pay in USDC via x402, no account.

Pricing

$0.0023 default

Parameters

{
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)",
      "type": "string"
    },
    "q": {
      "description": "Search query (brand or product name)",
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "next_step": {
    "body": {
      "slug": "<product slug from results>"
    },
    "url": "/x402/products/detail"
  },
  "products": [
    {
      "country": "US",
      "in_stock": true,
      "name": "Amazon",
      "recipient_type": "none",
      "slug": "amazon-us"
    },
    {
      "country": "US",
      "in_stock": true,
      "name": "Steam",
      "recipient_type": "none",
      "slug": "steam"
    }
  ]
}

GET/x402/products/detail

$0.0011 default

Description

Get a product's packages, pricing, and recipient requirements before creating an invoice.

Pricing

$0.0011 default

Parameters

{
  "properties": {
    "slug": {
      "description": "Product slug, e.g. amazon-us (from a search result or my/esims)",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "type": "object"
}

Example response

{
  "id": "amazon-us",
  "name": "Amazon",
  "next_step": {
    "body": {
      "items": [
        {
          "package_value": "25",
          "product_id": "amazon-us"
        }
      ]
    },
    "url": "/x402/invoice/create"
  },
  "packages": [
    {
      "package_currency": "USD",
      "package_value": "25"
    },
    {
      "package_currency": "USD",
      "package_value": "50"
    }
  ],
  "recipient_required": false,
  "recipient_type": "none"
}

GET/x402/topups/search

$0.0023 default

Description

Search mobile top-ups & prepaid airtime for carriers in 180+ countries. Pay in USDC via x402, no account.

Pricing

$0.0023 default

Parameters

{
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)",
      "type": "string"
    },
    "q": {
      "description": "Search query (carrier or operator name)",
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "next_step": {
    "body": {
      "slug": "<product slug from results>"
    },
    "url": "/x402/products/detail"
  },
  "products": [
    {
      "country": "GB",
      "in_stock": true,
      "name": "Vodafone",
      "recipient_type": "phone_number",
      "slug": "vodafone-gb"
    }
  ]
}