MapScale Docs
•••
API ReferenceHealth and contract
MapScale API
POST/v1/trial-key

Create a limited publishable trial key

Create a browser-safe evaluation key restricted to supported client-side products and your allowed origin.

LIVE API PLAYGROUND

Sign in or create an account

Continue to run live requests directly from the docs.

Sends this request to the live API and shows the real response.

Equivalent request
curl \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","companyName":"Your Company","allowedOrigin":"https://example.com"}' \
  "https://api.mapscale.io/v1/trial-key"
Response
Default response
{
  "accountId": "acct_trial_123",
  "key": "pk_test_••••••••",
  "keyPrefix": "pk_test_ab12cd34",
  "enabledProducts": [
    "tiles",
    "autocomplete",
    "static"
  ],
  "limits": {
    "rateLimitTier": "trial",
    "note": "Evaluation limits apply."
  },
  "examples": {
    "styleUrl": "https://api.mapscale.io/styles/v1/streets?key=pk_test_••••••••",
    "autocompleteUrl": "https://api.mapscale.io/v1/autocomplete?q=Siam&session_token=demo&key=pk_test_••••••••"
  }
}

Request body

Required · application/json

application/json
{
  "email": "[email protected]",
  "companyName": "Your Company",
  "allowedOrigin": "https://example.com"
}

Responses

201Successapplication/json
400Invalid request bodyapplication/json
429Too many requestsapplication/json
500The request could not be persistedapplication/json

On this page