# Cellulardata Ubigi — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse Ubigi's eSIM data plans across all countries and regions, viewing details like destination, plan type, data allowance, validity period, and pricing. Compare one-off plans or explore the complete catalog to find the best mobile data solution for your travel needs.

**Category:** Travel | **Website:** [cellulardata.ubigi.com/data-plans-and-coverage/ubigi-esim-data-plans/?one-off=on&monthly=on&annual=on](https://cellulardata.ubigi.com/data-plans-and-coverage/ubigi-esim-data-plans/?one-off=on&monthly=on&annual=on) | **Docs:** [parse.bot/marketplace/39300bdc-3935-472f-b0ed-d4272ad69551/cellulardata-ubigi-com-api](https://parse.bot/marketplace/39300bdc-3935-472f-b0ed-d4272ad69551/cellulardata-ubigi-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/cellulardata-ubigi/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all plans

Retrieve all eSIM data plans from Ubigi including one-off, monthly, and annual types. Supports filtering by country/destination and plan type. Returns the complete catalog or a filtered subset with full pricing, validity, and coverage details. Paginates as a single page containing all results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by country or destination name, or 3-letter ISO code (e.g. 'France', 'FRA'). Case-insensitive partial match on destination name or exact match on ISO code. |
| `plan_type` | string | No | Filter by plan type. Accepted values: 'one-off', 'monthly', 'annual'. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cellulardata-ubigi/get-all-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","plan_type":"<string>"}'
```

### Get destinations

Retrieve all unique destinations (countries and regions) available for Ubigi eSIM plans, with summary statistics per destination including plan count, available plan types, minimum price, and maximum data allowance. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cellulardata-ubigi/get-destinations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get oneoff plans

Retrieve one-off (single-use) eSIM data plans from Ubigi. Supports filtering by country/destination name or ISO code, continent, minimum data allowance in GB, and maximum price in USD. Returns all matching one-off plans with full pricing, validity, and coverage details. Paginates as a single page containing all results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `continent` | string | No | Filter by continent. Accepted values: ASIA, EUROPE, AFRICA, CARIBBEAN, AMERICAS, MIDDLE-EAST, OCEANIA, WORLD. |
| `country` | string | No | Filter by country or destination name, or 3-letter ISO code (e.g. 'Japan', 'JPN'). Case-insensitive partial match on destination name or exact match on ISO code. |
| `max_price` | number | No | Maximum price in USD. Only plans priced at or below this value are returned. |
| `min_allowance` | number | No | Minimum data allowance in GB. Only plans with at least this much data are returned. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cellulardata-ubigi/get-oneoff-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"continent":"<string>","country":"<string>","max_price":"<number>","min_allowance":"<number>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.