POST MileageCategories/SaveDateRangeThresholds?mileageCategoryId={mileageCategoryId}&dateRangeId={dateRangeId}

Request Parameters
Request Samples
Response Samples

Parameters

Name	Description	Additional information
request	The MileageThresholdRequest	Define this parameter in the request body.
mileageCategoryId	The Id of the parent MileageCategory	Define this parameter in the request URI.
dateRangeId	The Id of the DateRange the Thresholds belong to	Define this parameter in the request URI.

Request body formats

application/json, text/json

Sample:

{
  "Thresholds": [
    {
      "MileageThresholdId": 1,
      "MileageDateId": 2,
      "MileageCategoryId": 3,
      "RangeValue1": 1.0,
      "RangeValue2": 1.0,
      "RangeType": 0,
      "Passenger1Rate": 4.0,
      "PassengerXRate": 5.0,
      "HeavyBulkyEquipmentRate": 6.0,
      "Rates": [
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        }
      ]
    },
    {
      "MileageThresholdId": 1,
      "MileageDateId": 2,
      "MileageCategoryId": 3,
      "RangeValue1": 1.0,
      "RangeValue2": 1.0,
      "RangeType": 0,
      "Passenger1Rate": 4.0,
      "PassengerXRate": 5.0,
      "HeavyBulkyEquipmentRate": 6.0,
      "Rates": [
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        }
      ]
    },
    {
      "MileageThresholdId": 1,
      "MileageDateId": 2,
      "MileageCategoryId": 3,
      "RangeValue1": 1.0,
      "RangeValue2": 1.0,
      "RangeType": 0,
      "Passenger1Rate": 4.0,
      "PassengerXRate": 5.0,
      "HeavyBulkyEquipmentRate": 6.0,
      "Rates": [
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        },
        {
          "MileageThresholdRateId": 1,
          "CreatedBy": 1,
          "CreatedOn": "2025-12-05T15:04:18.1828001+00:00",
          "ModifiedBy": 1,
          "ModifiedOn": "2025-12-05T15:04:18.1828001+00:00",
          "MileageThresholdId": 1,
          "VehicleEngineTypeId": 1,
          "RatePerUnit": 1.0,
          "AmountForVat": 1.0
        }
      ]
    }
  ]
}

application/xml, text/xml

Sample:

<MileageThresholdRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Requests">
  <Thresholds xmlns:d2p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types">
    <d2p1:Threshold>
      <d2p1:HeavyBulkyEquipmentRate>6</d2p1:HeavyBulkyEquipmentRate>
      <d2p1:MileageCategoryId>3</d2p1:MileageCategoryId>
      <d2p1:MileageDateId>2</d2p1:MileageDateId>
      <d2p1:MileageThresholdId>1</d2p1:MileageThresholdId>
      <d2p1:Passenger1Rate>4</d2p1:Passenger1Rate>
      <d2p1:PassengerXRate>5</d2p1:PassengerXRate>
      <d2p1:RangeType>GreaterThanOrEqualTo</d2p1:RangeType>
      <d2p1:RangeValue1>1</d2p1:RangeValue1>
      <d2p1:RangeValue2>1</d2p1:RangeValue2>
      <d2p1:Rates xmlns:d4p1="http://schemas.datacontract.org/2004/07/SpendManagementLibrary">
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
      </d2p1:Rates>
    </d2p1:Threshold>
    <d2p1:Threshold>
      <d2p1:HeavyBulkyEquipmentRate>6</d2p1:HeavyBulkyEquipmentRate>
      <d2p1:MileageCategoryId>3</d2p1:MileageCategoryId>
      <d2p1:MileageDateId>2</d2p1:MileageDateId>
      <d2p1:MileageThresholdId>1</d2p1:MileageThresholdId>
      <d2p1:Passenger1Rate>4</d2p1:Passenger1Rate>
      <d2p1:PassengerXRate>5</d2p1:PassengerXRate>
      <d2p1:RangeType>GreaterThanOrEqualTo</d2p1:RangeType>
      <d2p1:RangeValue1>1</d2p1:RangeValue1>
      <d2p1:RangeValue2>1</d2p1:RangeValue2>
      <d2p1:Rates xmlns:d4p1="http://schemas.datacontract.org/2004/07/SpendManagementLibrary">
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
      </d2p1:Rates>
    </d2p1:Threshold>
    <d2p1:Threshold>
      <d2p1:HeavyBulkyEquipmentRate>6</d2p1:HeavyBulkyEquipmentRate>
      <d2p1:MileageCategoryId>3</d2p1:MileageCategoryId>
      <d2p1:MileageDateId>2</d2p1:MileageDateId>
      <d2p1:MileageThresholdId>1</d2p1:MileageThresholdId>
      <d2p1:Passenger1Rate>4</d2p1:Passenger1Rate>
      <d2p1:PassengerXRate>5</d2p1:PassengerXRate>
      <d2p1:RangeType>GreaterThanOrEqualTo</d2p1:RangeType>
      <d2p1:RangeValue1>1</d2p1:RangeValue1>
      <d2p1:RangeValue2>1</d2p1:RangeValue2>
      <d2p1:Rates xmlns:d4p1="http://schemas.datacontract.org/2004/07/SpendManagementLibrary">
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
        <d4p1:VehicleJourneyRateThresholdRate>
          <d4p1:AmountForVat>1</d4p1:AmountForVat>
          <d4p1:CreatedBy>1</d4p1:CreatedBy>
          <d4p1:CreatedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:CreatedOn>
          <d4p1:MileageThresholdId>1</d4p1:MileageThresholdId>
          <d4p1:MileageThresholdRateId>1</d4p1:MileageThresholdRateId>
          <d4p1:ModifiedBy>1</d4p1:ModifiedBy>
          <d4p1:ModifiedOn>2025-12-05T15:04:18.1828001+00:00</d4p1:ModifiedOn>
          <d4p1:RatePerUnit>1</d4p1:RatePerUnit>
          <d4p1:VehicleEngineTypeId>1</d4p1:VehicleEngineTypeId>
        </d4p1:VehicleJourneyRateThresholdRate>
      </d2p1:Rates>
    </d2p1:Threshold>
  </Thresholds>
</MileageThresholdRequest>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response body formats

A NumericResponse. The outcome of the action, where 1 incidicates success

application/json, text/json

Sample:

{
  "Item": 1,
  "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:

<NumericResponse 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>
  <Item xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">1</Item>
</NumericResponse>

POST MileageCategories/SaveDateRangeThresholds?mileageCategoryId={mileageCategoryId}&dateRangeId={dateRangeId}

Parameters

Request body formats

application/json, text/json

application/xml, text/xml

application/x-www-form-urlencoded

Response body formats

application/json, text/json

application/xml, text/xml

URI parameters

Headers | Add header

Body

Status

Headers

Body