SAsamsara
Beta APIs

[beta] Create an electric purchase transaction.

Create an electric charging purchase transaction, measured in kilowatt hours.

<b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select Write Fuel Purchase under the Fuel & Energy category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

post/electric-purchase

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Request body

driverIdstring

Samsara ID of the driver.

energyKilowattHoursstring required

The amount of energy delivered in kilowatt hours, as a decimal string greater than 0.

merchantNamestring

Name of the charging network or operator. For example: ChargePoint, Electrify America.

sourcestring

The integration provider. For example: Customer, ChargePoint Integration

transactionLocationstring required

The full street address of the charger, as it might be recognized by Google Maps (example: 1 De Haro St, San Francisco, CA 94107, United States). Alternatively, exact latitude/longitude can be provided (example: 40.748441, -73.985664).

transactionReferencestring required

The charging transaction reference. This is the transaction identifier, such as the receipt or charging session number.

transactionTimestring required

The time of the charging transaction in RFC 3339 format. Timezone must be specified. For example, 2022-07-13T14:20:50.52-07:00 is a time in Pacific Daylight Time.

vehicleIdstring

Samsara ID of the vehicle that was charged.

Example request

{
  "discount": {
    "amount": "640.2",
    "currency": "usd"
  },
  "driverId": "1234",
  "energyKilowattHours": "42.7",
  "merchantName": "ChargePoint",
  "source": "ChargePoint Integration",
  "transactionLocation": "350 Rhode Island St, San Francisco, CA 94103",
  "transactionPrice": {
    "amount": "640.2",
    "currency": "usd"
  },
  "transactionReference": "CP-88231",
  "transactionTime": "2026-10-12T08:41:05-07:00",
  "vehicleId": "281474900488527"
}

Response

OK response.

Example response

{
  "data": {
    "discount": {
      "amount": "640.2",
      "currency": "usd"
    },
    "driverId": "1234",
    "energyKilowattHours": "42.7",
    "id": "9814a1fa-f0c6-408b-bf85-51dc3bc71ac7",
    "merchantName": "ChargePoint",
    "source": "ChargePoint Integration",
    "transactionLocation": "350 Rhode Island St, San Francisco, CA 94103",
    "transactionPrice": {
      "amount": "640.2",
      "currency": "usd"
    },
    "transactionReference": "CP-88231",
    "transactionTime": "2026-10-12T08:41:05-07:00",
    "vehicleId": "281474900488527"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.