MOmonta
Charges

Record an odometer reading for a charge

Changed on

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

The reading is stored with source set to partner_api — provenance cannot be chosen by the caller. Readings are append-only evidence: implausible jumps and decreases are never rejected at write time, they are surfaced asynchronously as verification results. To correct history, record a new reading.

post/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

Request body

odometerKminteger required

Odometer reading in whole kilometres. Values outside 0-4000000 are rejected with 422.

readingAtstring date-time nullable

When the reading was taken (ISO8601: yyyy-MM-ddTHH:mm:ssZ). Defaults to the time of the request.

sourceRefstring nullable

Your own identifier for this reading, echoed back on reads. Maximum 128 characters.

Example request

{
  "odometerKm": 42500,
  "readingAt": "2026-05-21T11:55:00Z",
  "sourceRef": "fleet-run-9"
}

Response

Odometer reading recorded

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