> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.simjuno.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simjuno.com/_mcp/server.

# Authentication

> Create a SimJuno API key and authenticate your first request.

Every request to the SimJuno v1 reseller API must include an API key in the `x-api-key` header. API keys begin with `juno_` and identify your SimJuno account. Each request counts against your [rate limit](/rate-limits) of 8 requests per 1-second window.

## Create an API key

Sign in to the [SimJuno Dashboard](https://simjuno.com/dashboard/settings) and follow these steps:

![Creating and copying a SimJuno API key](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/simjuno.docs.buildwithfern.com/6f90fae0d448c3e76af27e0903245293c5de219b6c64781dd449708d5dea22b6/docs/assets/create-api-key.gif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260909%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260909T205902Z&X-Amz-Expires=604800&X-Amz-Signature=9b66ab09c4389e4cca592b21cfc34da36d005348ce8e8b3559ca81c99108d499&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Copy the key immediately—SimJuno shows the full value only once. Store it in a secret manager or an environment variable such as `SIMJUNO_API_KEY`. If you lose it, create a replacement and delete the old key.

## Make an authenticated request

Then send it in the `x-api-key` header. This request verifies access and returns your reseller wallet balance:

```bash
curl "https://api.simjuno.com/v1/reseller/balance" \
  --header "x-api-key: $SIMJUNO_API_KEY"
```

A successful response has this shape:

```json
{
  "balance": 30000,
  "discount_percent": 10
}
```

The `balance` value uses a factor of 10,000. Divide it by 10,000 to convert it to US dollars; for example, `30000 / 10000 = $3.00`.

`discount_percent` is the account-wide discount SimJuno has granted your account, as a percentage. Package endpoints list full prices; the discount is taken off each package price when you order or top up, so the amount debited from your wallet is `price × (1 − discount_percent / 100)`, rounded to the nearest unit. It is `0` for accounts without a discount.