SimJuno Docs

Get esim usage by id. Usage and status are polled from the upstream provider at most once every 5 minutes; within that window the last known values are returned unless force is set.

Authentication

x-api-keystring

API key generated from the dashboard (Settings → API Keys). Each key is limited to 8 requests per 1-second window.

Path parameters

idstringRequired

Query parameters

forcebooleanOptional

Poll the upstream provider even if the eSIM was refreshed within the last 5 minutes.

Response

Successful response

dataUsagedouble

totalDatadouble

lastDataUsageUpdateTimestring or null

esimStatusstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

1	const url = 'https://api.simjuno.com/v1/esim/id/usage';
2	const options = {method: 'GET', headers: {'x-api-key': '<apiKey>'}};
3
4	try {
5	const response = await fetch(url, options);
6	const data = await response.json();
7	console.log(data);
8	} catch (error) {
9	console.error(error);
10	}

1	{
2	"dataUsage": 1.1,
3	"totalData": 1.1,
4	"lastDataUsageUpdateTime": "string",
5	"esimStatus": "string"
6	}