canonical: https://jentic.com/apis/esimoa.com/esimoa # esimoa Partner API The esimoa Partner API searches and compares travel eSIM plans sold by esimoa, filtering by destination country, validity in days, and data allowance. Each result includes a purchase link carrying your partner code, so purchases made through it earn a commission. A countries operation lists the destinations that currently have plans on sale, and plan details can be fetched by id. ## For AI agents Search and compare travel eSIM plans by country, duration, and data, fetch a single plan by id, and list destinations with plans on sale. Each result carries a partner purchase link. Authenticated with an X-API-Key header. ## Scope Does not handle eSIM activation, provisioning, or payment processing. Use for searching and comparing travel eSIM plans only. ## Capabilities - Search and compare travel eSIM plans by destination country, validity days, and data allowance - Filter results to unlimited-data plans, a specific provider, or multi-country plans - Retrieve the full details of one eSIM plan by its id - List the countries that currently have eSIM plans on sale - Return a purchase link carrying your partner code so purchases earn a commission ## Use cases ### Travel eSIM Comparison A travel assistant finds the right data plan for an upcoming trip. The esimoa Partner API searches plans by destination country, validity in days, and minimum data, and can narrow results to unlimited plans or a single provider, returning comparable options with prices so the traveller can choose before departure. Example prompt: Search esimoa for eSIM plans with country JP and a minimum data allowance, sorted by the recommended order, and return the top options with prices ### Affiliate eSIM Recommendations A publisher embeds eSIM recommendations that earn commission. The esimoa Partner API returns a purchase link with the publisher's partner code on every plan, so an agent can surface a best-fit plan for a destination and hand back a link the reader can buy through while attributing the sale. Example prompt: Fetch the details for a chosen eSIM plan by its id and return its partner purchase link for the reader ### AI Agent Travel Planning via Jentic An AI travel agent adds connectivity to a trip plan through Jentic without holding the esimoa API key itself. It searches by intent, receives the matching operation and its input schema, and queries plans with the credential injected at run time, so it can recommend a data plan alongside flights and lodging. Example prompt: Search Jentic for 'compare travel eSIM plans', load the search operation schema, and query plans for the destination with Jentic-managed credentials ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/esims` | Search and compare eSIM plans | | GET | `/v1/esims/{id}` | Get the details of one eSIM plan | | GET | `/v1/countries` | List countries with plans on sale | ## Key resources - **eSIM Plans** — Search and compare plans via `/v1/esims` and fetch one plan by id via `/v1/esims/{id}` - **Countries** — List destinations with plans on sale via `/v1/countries` ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 60 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 60 / 100 - AI-Readiness & Agent Experience: 44 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 50 / 100 - **View full report:** https://jentic.com/apis/esimoa.com/esimoa/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring esimoa by hand means sending its X-API-Key header, building the query filters for country and data, and threading your partner code through every purchase link yourself. Through Jentic you install once, import esimoa from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** This API is read-only: every operation is a GET for searching plans, reading one plan, or listing countries, so a rule can confine your agent to those reads and nothing that changes account state. You choose which of the three operations it may call. - **Credential handling:** Your esimoa partner key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'compare travel eSIM plans' or 'list countries with eSIM plans', and Jentic returns the matching esimoa operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Amadeus Flight Offers Search** — Search flight offers to plan the travel the eSIM is bought for - **Booking.com API** — Search and book accommodation for the same trip ## FAQ ### What authentication does the esimoa Partner API use? The esimoa Partner API authenticates with an API key sent in the X-API-Key header per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never reaches the agent. ### Can I filter eSIM plans by country and data with the esimoa Partner API? Yes. The search operation accepts query filters for the destination country, the validity in days, a minimum or maximum data allowance, unlimited-data-only, a specific provider, and multi-country plans. An agent can combine these to return a short, comparable list of plans for a trip. ### What are the rate limits for the esimoa Partner API? The OpenAPI spec does not specify rate limits for the esimoa Partner API. Check the esimoa developer documentation for current limits, and use the search operation's limit and offset parameters to page through results efficiently. ### How do I compare eSIM plans with the esimoa Partner API through Jentic? Search Jentic for 'compare travel eSIM plans' and it returns the esimoa search operation with its input schema. Load the schema, pass the destination and data filters, and the key is injected at run time. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the esimoa Partner API? Yes. Every operation in this API is a read-only GET, so a rule can confine your agent to searching plans, fetching plan details, and listing countries, and nothing that changes state. You choose which of the three reads it may call, and every request runs through your own instance where it is logged. ### Is there an esimoa Partner API MCP server? You don't need an MCP server to give your agent the esimoa Partner API. Jentic connects it directly from the API Directory: import it, store your partner key once, and your agent calls the search and countries operations it needs without a separate server to install.