MOmonta
Charges

Retrieve every odometer reading recorded for a charge

Changed on

Required scope: charge-odometer:read </br>Organization authorization: supported

Readings are returned oldest first. This endpoint is not paginated: a charge holds a handful of readings at most, so the full set is always returned and no page or perPage parameter is accepted.

get/api/v1/charges/{chargeId}/odometer-readings

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/charges/{chargeId}/odometer-readings
  • Auth
    HTTP bearer

Path parameters

chargeIdinteger required

Response

Odometer readings for the given charge, oldest first

idinteger required

Id of the odometer reading

chargeIdinteger required

Id of the charge the reading belongs to

vehicleIdinteger nullable

Id of the vehicle the reading was taken from. Null when the charge has no vehicle assigned.

odometerKminteger required

Odometer reading in whole kilometres

readingAtstring date-time required

When the reading was taken (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

source'vehicle_integration' | 'manual_app' | 'manual_hub' | 'partner_api' required

Where the reading came from

sourceLabelstring required

Human-readable label for source

sourceRefstring nullable

Your own identifier for this reading, echoed back as you sent it

capturePhase'start' | 'stop' | 'manual' required

Point in the charge lifecycle the reading was captured at. Readings you push are always manual.

confidence'verified' | 'declared' required

How trustworthy the value is: verified for a Monta vehicle integration, declared for anything a human or a partner reported

confidenceLabelstring required

Human-readable label for confidence

editableboolean required

True only for readings you pushed yourself. Readings from a vehicle integration, the driver app or the operator hub are another party's evidence and cannot be patched or deleted.

createdAtstring date-time nullable

When the reading was recorded (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

Example response

[
  {
    "id": 1,
    "chargeId": 1234,
    "vehicleId": 99,
    "odometerKm": 42500,
    "readingAt": "2026-05-21T11:55:00Z",
    "source": "partner_api",
    "sourceLabel": "Partner API",
    "sourceRef": "fleet-run-9",
    "capturePhase": "manual",
    "confidence": "declared",
    "confidenceLabel": "Declared",
    "editable": true,
    "createdAt": "2026-05-21T12:00:00Z"
  }
]

Changes