Help Centre / API / Authenticating requests

Authenticating requests

Updated just now · 7 views ·

Every request to the MapVS API needs an Authorization header with a Bearer token.

Header format

Authorization: Bearer vs_YOUR_KEY_HERE

curl example

curl https://mapvs.com/api/v1/maps \
  -H "Authorization: Bearer vs_1234abcd..."

Response codes

  • 200 - success
  • 401 - missing, malformed, or revoked token
  • 403 - authenticated but not permitted for this resource
  • 429 - rate limit exceeded

Session cookies vs API keys

The web UI uses session cookies. The API only accepts Bearer tokens - session cookies are ignored on /api/v1 routes. Keep them separate.

Was this article helpful?

0 found this helpful

Related Articles

Getting an API key

How to create, view, and revoke API keys for programmatic access to MapVS.

Rate limits

Per-key limits, headers to inspect, and how to back off gracefully.

Errors and status codes

The complete list of status codes and error envelope format returned by the MapVS API.

Pagination

List endpoints paginate. Learn the query parameters and how to iterate cleanly.