API

API guide

Everything the dashboard does — pairing, credentials, rotation, usage — is one REST API. Base URL https://mobileproxy.app/api/v1. Authenticate with a bearer token.

Authentication

Create a token in the dashboard under For developers → API tokens, or with POST /tokens while signed in. The secret is shown once — store it. Send it on every request:

Authorization: Bearer mpx_live_…

Try it live

The interactive console lets you paste a token and call every endpoint from the browser, with request bodies and real responses. The full spec is at /api/v1/openapi.json.

Errors

Errors are JSON with a human message and a machine code:

{ "error": "No such device.", "code": "not_found" }

Field	Type	Description
401	unauthorized	Token missing, malformed, or revoked.
403	forbidden	Token valid but not permitted.
404	not_found	Resource doesn't exist on this account.
502	control_plane_unavailable	Gateway briefly unreachable — retry.

Common recipes

List your devices with live status and exit IP:

curl https://mobileproxy.app/api/v1/subscriptions \
     -H "Authorization: Bearer mpx_live_…"

Rotate a device's IP and confirm from IP history:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…"

curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/ip-history \
     -H "Authorization: Bearer mpx_live_…"

Provision a proxy for a new customer — one credential, ready to hand off:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…"
# → returns endpoint: socks5h://user:pass@host:port

Read account-wide usage for billing:

curl https://mobileproxy.app/api/v1/usage/summary \
     -H "Authorization: Bearer mpx_live_…"

Full reference

Every endpoint, parameter, schema, and example response is in the interactive console. It renders live from the same OpenAPI document the API is built from, so it never drifts out of date.