POST OdometerReadings/SaveOdometerReadings

Adds list of OdometerReadings.


Parameters

NameDescriptionAdditional information
request
The OdometerReading with business mileage option to add. 
            When adding a new OdometerReading through the API, the following properties are required:
            Id: Must be set to 0, or the add will throw an error.
            CarId: Must be set to the Id of an existing car, or the add will throw an error.
            TakenOn: The OdometerReading must have been taken on a valid date.
            Old: Every OdometerReading must have an old reading.
            New: Every OdometerReading must have a new reading.

Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:
{
  "OdometerReadings": [
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1096211+00:00",
      "OldReading": 4,
      "NewReading": 5
    },
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1096211+00:00",
      "OldReading": 4,
      "NewReading": 5
    },
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1096211+00:00",
      "OldReading": 4,
      "NewReading": 5
    }
  ],
  "BusinessMiles": true
}

application/xml, text/xml

Sample:
<OdometerReadingBusiness xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types.OdometerReadingBusiness">
  <BusinessMiles>true</BusinessMiles>
  <OdometerReadings xmlns:d2p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types">
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1096211+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1096211+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1096211+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
  </OdometerReadings>
</OdometerReadingBusiness>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response body formats

A GetOdometerReadingsResponse containing the added OdometerReadings.

application/json, text/json

Sample:
{
  "List": [
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1260471+00:00",
      "OldReading": 4,
      "NewReading": 5
    },
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1260471+00:00",
      "OldReading": 4,
      "NewReading": 5
    },
    {
      "OdometerReadingId": 1,
      "CarId": 2,
      "ReadingDate": "2025-01-26T07:12:49.1260471+00:00",
      "OldReading": 4,
      "NewReading": 5
    }
  ],
  "ResponseInformation": {
    "Errors": [
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      },
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      },
      {
        "ErrorCode": "sample string 1",
        "Message": "sample string 2"
      }
    ],
    "Status": 0,
    "Links": [
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      },
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      },
      {
        "Rel": "sample string 1",
        "Href": "sample string 2",
        "Title": "sample string 3",
        "IsTemplated": true
      }
    ]
  }
}

application/xml, text/xml

Sample:
<GetOdometerReadingsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Responses">
  <ResponseInformation xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">
    <Errors>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
      <ApiErrorDetail>
        <ErrorCode>sample string 1</ErrorCode>
        <Message>sample string 2</Message>
      </ApiErrorDetail>
    </Errors>
    <Links>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
      <Link>
        <Href>sample string 2</Href>
        <IsTemplated>true</IsTemplated>
        <Rel>sample string 1</Rel>
        <Title>sample string 3</Title>
      </Link>
    </Links>
    <Status>Failure</Status>
  </ResponseInformation>
  <List xmlns:d2p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1260471+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1260471+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
    <d2p1:OdometerReading>
      <d2p1:CarId>2</d2p1:CarId>
      <d2p1:NewReading>5</d2p1:NewReading>
      <d2p1:OdometerReadingId>1</d2p1:OdometerReadingId>
      <d2p1:OldReading>4</d2p1:OldReading>
      <d2p1:ReadingDate>2025-01-26T07:12:49.1260471+00:00</d2p1:ReadingDate>
    </d2p1:OdometerReading>
  </List>
</GetOdometerReadingsResponse>
URI parameters
=
Headers | Add header
: Delete
Body
Samples:
Status
Headers
Body