Get subscription

GET /v1/billing/subscriptionFreeRead-only

The account's plan and subscription: plan, status, when the period renews or ends, whether it is set to cancel, the price, and this month's units against the plan. Free. Call it before suggesting an upgrade, and after handing a human a checkout link to see when the payment went through (plan changes from free to the plan bought, usually within seconds).

MCP tool get_subscription · CLI geocode get-subscription · RPC POST /v1/ops/get_subscription

Input

None.

Example request

curl "https://geo-coder-service.vercel.app/v1/billing/subscription" \  -H "Authorization: Bearer $GEOCODE_API_KEY"

Example response

See the description above for what this returns.

Errors

Failures are RFC 9457 problems. Common ones here: 400 invalid_input, 401 unauthorized, 429 rate_limited.