API reference / Vehicle / DL
FASTag last location
The most recent toll-plaza readings for a vehicle's FASTag.
POST
/v1/vehicle/fastag/history- Authentication
- Bearer token
- Scope
vehicle:read
Before you integrate
- An empty events list means the tag has not been read recently; it is not an error.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
vehicle_number | string | Yes | Vehicle registration number, 4 to 15 letters and digits, for example MH12AB1234. Case, spaces and hyphens are ignored. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/vehicle/fastag/history' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"vehicle_number": "MH12AB1234"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"events": [
{
"reader_read_time": "2026-10-30 09:12:44",
"seq_no": "1",
"lane_direction": "N",
"toll_plaza_geocode": "19.0760,72.8777",
"toll_plaza_name": "EXAMPLE TOLL PLAZA",
"vehicle_type": "VC4",
"vehicle_reg_no": "MH12AB1234"
}
]
}
}Response fields
| Field | Type | Description |
|---|---|---|
events | array | The most recent toll-plaza readings, newest information first as returned; empty when there was no movement. |
events[].reader_read_time | string | When the tag was read. |
events[].seq_no | string | Sequence number of the reading. |
events[].lane_direction | string | Direction of the lane. |
events[].toll_plaza_name | string | Name of the toll plaza. |
events[].toll_plaza_geocode | string | Latitude and longitude of the toll plaza. |
events[].vehicle_type | string | Toll class of the vehicle. |
events[].vehicle_reg_no | string | Registration number the tag was read for. |
message | string | A note about the lookup, present only in some replies. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.