API doc & reference

Estimated reading time: 2 minutes

Get started using Jawg APIs

Jawg's products help you put a map anywhere, search and route the planet. Here is the list of all our documentation.

  • Jawg Elevation to get elevation values along a path anywhere on Earth's surface.
  • Jawg Maps service to get maps in raster or vector.
  • Jawg Places to add search bar in your maps.
  • Jawg Routing to add turn-by-turn routing in your maps.
  • Jawg Static Maps to get standalone images of your map that can be displayed on web and mobile devices without requiring JavaScript or any dynamic page loading.

Basic plan restrictions

By using our services with a basic plan, you will face various restrictions. If you are facing those restrictions, feel free to contact us or upgrade your account to one of our plans.

Quota limits

You cannot exceed your free quota with this plan. When your free quota is exceeded you will receive a HTTP 401 Unauthorized response from our APIs. The response may also say QUOTA_EXCEEDED. The quota is reset on your renwal date.

Rate limits

If you exceed your rate limit, you will receive a HTTP 429 Too Many Requests response from our APIs.

The following table list our current rate limit for each service. The rate limit is counted per account and IP.

API Default requests per seconds
Maps 100 requests per second
Static Maps 1 request per second
Elevation 1 request per second
Places 1 request per second
Routing 1 request per second

Common API responses

Status Code Message code Description
400 NO_ACCESS_TOKEN_PROVIDED The query paramater access-token= is missing from your request.
400 INVALID_ACCESS_TOKEN The value of the query parameter access-token= contains invalid characters.
401 ACCESS_TOKEN_QUOTA_EXCEEDED The quota defined for the provided access-token has been exceeded for the current period. (available for paid plans only)
401 QUOTA_EXCEEDED Your free quota has been exceeded for the current period. It will be reset on your renewal date.
401 UNAUTHORIZED You are not authorized to access this API.
403 ACCESS_TOKEN_NOT_FOUND The provided access-token does not exist. Check your Jawg Lab account.
403 RESTRICTED_LAYER The provided access-token cannot access style style. Only available for Dynamic Maps and Static Maps.
403 RESTRICTED_ORIGIN The website cannot access to the API with this access-token. (available for paid plans only)
429 TOO_MANY_REQUESTS You have reached your rate limit.