Create billing portal link
POST /v1/billing/portalFreeWrites
A link for the account's owner to open Stripe's Customer Portal: download invoices, change the card or billing details, switch plans, or cancel (at the end of the period already paid for). Free. The link does not expire; it asks the person to sign in to Geocode AI, then opens the portal. Fails with no_subscription when the account never had a paid plan.
MCP tool create_billing_portal_link · CLI geocode create-billing-portal-link · RPC POST /v1/ops/create_billing_portal_link
Input
None.
Example request
curl -X POST "https://geo-coder-service.vercel.app/v1/billing/portal" \ -H "Authorization: Bearer $GEOCODE_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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.