Docs
Developer CenterDashboardesimoa.com
    • Introduction
    • Quickstart
    • Authentication
    • Overview
    • List eSIMs
    • Get an eSIM
    • Countries
    • OpenAPI
    • Tracking & commission
    • Rate limits & errors
    • Overview
    • Claude
    • ChatGPT
    • Gemini
    • Other MCP clients
    • Overview
    • Authentication
    • Products
    • Product detail
    • Countries
    • Errors & rate limits
  1. Docs
  2. Public API (/v1)
  3. OpenAPI

Public API (/v1)

OpenAPI

The OpenAPI 3.1 spec, available without a key — import it into GPT Actions, function calling or code generators.

On this page
  • Download the spec
  • Use with GPT Actions
  • Generate a client

Download the spec#

GET/v1/openapi.json

An OpenAPI 3.1 spec. It needs no key and can be imported directly into GPT Actions or function-calling tools: https://api.esimoa.com/v1/openapi.json

shell
curl https://api.esimoa.com/v1/openapi.json -o esimoa-openapi.json

Note

The spec is the same contract as these docs. Response fields are only ever added — names and meanings do not change. The spec is cached for one hour.

Use with GPT Actions#

To use a custom GPT with Actions, import the schema from https://api.esimoa.com/v1/openapi.json — set authentication to API key with the custom header name X-API-Key.

Generate a client#

Use standard OpenAPI tooling to generate types or a client library.

shell
# TypeScript types
npx openapi-typescript https://api.esimoa.com/v1/openapi.json -o esimoa.d.ts

# Any language (Python, Go, Java, …)
npx @openapitools/openapi-generator-cli generate \
  -i https://api.esimoa.com/v1/openapi.json -g python -o ./esimoa-client

Last updated: October 1, 2026

PreviousCountriesNextTracking & commission

On this page

  • Download the spec
  • Use with GPT Actions
  • Generate a client

APIs and MCP for bringing esimoa eSIMs to your product

Resources

  • Docs
  • API reference
  • Partner API (B2B)
  • MCP server
  • OpenAPI spec

esimoa

  • Home
  • eSIM plans
  • Developer Center
  • Dashboard
  • Partner portal

Company

  • About Us
  • Partnership
  • Terms of Service
  • Privacy Policy
  • Delivery & Refunds Policy

Support

  • support@esimoa.com
  • Support chat

NBase Korea Co., Ltd.

902, Bldg A, 767 Sinsu-ro, Suji-gu, Yongin-si, Gyeonggi-do (Dongcheon-dong, Bundang Suji U-TOWER)

US Headquarters: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. All rights reserved.