LocateNG API
Build location resolution and recipient confirmation into your product with organization-scoped credentials and predictable responses.
Authentication
Send your project key in the Authorization header as a Bearer token. Keys are scoped to one project and shown only once.
POST /v1/locations/resolve
Resolve a supported location reference into a structured location response.
GET /v1/locations/:id
Retrieve one location owned by the authenticated project’s organization.
POST /v1/verifications
Create a recipient confirmation request. Supply an Idempotency-Key for safe retries.
GET /v1/verifications/:id
Retrieve lifecycle status, expiration and the linked location result.
POST /v1/verifications/:id/revoke
Revoke an active request before it reaches a terminal status.
GET /v1/usage
Read project usage for the current billing period.
Errors, limits and webhooks
Responses use stable error codes with a request identifier. Rate-limit headers describe remaining capacity and reset time. Webhook deliveries include a timestamped HMAC signature, retry with backoff, and can be replayed from the application.