# iGps

## Docs

- [iGps REST API: Real-Time GPS Vehicle Tracking by VIN](https://dev.igps.com.br/introduction.md): iGps is a REST API that provides real-time GPS positions for vehicles identified by chassis (VIN) number. Learn what iGps does and how to integrate it.
- [iGps Quickstart: Make Your First API Call in Minutes](https://dev.igps.com.br/quickstart.md): Follow this step-by-step guide to authenticate with the iGps API and retrieve your first real-time GPS vehicle position by chassis number.
- [iGps API Authentication: Obtain and Use Bearer Tokens](https://dev.igps.com.br/authentication.md): Learn how to exchange your client_id and client_secret for a short-lived Bearer token and authorize all subsequent iGps API requests.
- [iGps API Concepts: Authentication, Tokens, and Positions](https://dev.igps.com.br/concepts/overview.md): Learn the core iGps concepts — credentials, Bearer tokens, chassis numbers, and the end-to-end flow for querying real-time vehicle positions.
- [Vehicle Position Fields, Status Codes, and Response Shape](https://dev.igps.com.br/concepts/vehicle-positions.md): Understand the structure of vehicle position results returned by iGps, including coordinate fields, timestamps, and per-vehicle status codes.
- [Handling iGps API Errors: 400, 401, 429, and 500 Codes](https://dev.igps.com.br/concepts/error-handling.md): Learn how iGps signals errors through HTTP status codes and how to handle authentication failures, validation errors, and rate limits in your integration.
- [Make Your First iGps API Request: Auth and Positions](https://dev.igps.com.br/guides/first-request.md): A step-by-step walkthrough of authenticating with iGps and querying real-time vehicle GPS positions using curl, Python, and JavaScript.
- [Batch Querying Vehicle Positions with the iGps API](https://dev.igps.com.br/guides/batch-query.md): Learn how to use iGps batch queries to retrieve GPS positions for up to 50 vehicles in a single API call, reducing latency and API overhead.
- [Understanding iGps API Rate Limits and Retry Logic](https://dev.igps.com.br/guides/rate-limits.md): Learn how iGps enforces rate limits on API requests and how to handle 429 errors with retry logic to keep your integration running smoothly.
- [POST /api/v1/auth/token — Get Bearer Access Token](https://dev.igps.com.br/api-reference/auth/token.md): Exchange your client_id and client_secret for a Bearer access token. The token is valid for 3600 seconds and authorizes all API requests.
- [POST /api/v1/veiculos/posicoes — Query Vehicle Positions](https://dev.igps.com.br/api-reference/vehicles/positions.md): Retrieve the latest GPS position for up to 50 vehicles by chassis number. Returns coordinates, timestamp, and a status for each vehicle.