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

FieldTypeRequiredDescription
vehicle_numberstringYesVehicle 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

FieldTypeDescription
eventsarrayThe most recent toll-plaza readings, newest information first as returned; empty when there was no movement.
events[].reader_read_timestringWhen the tag was read.
events[].seq_nostringSequence number of the reading.
events[].lane_directionstringDirection of the lane.
events[].toll_plaza_namestringName of the toll plaza.
events[].toll_plaza_geocodestringLatitude and longitude of the toll plaza.
events[].vehicle_typestringToll class of the vehicle.
events[].vehicle_reg_nostringRegistration number the tag was read for.
messagestringA 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.