POST api/v1/ServiceLevel

Retrieve the list of despatch service levels.
It may be desirable to tell Caliq than an order needs to be despatched to the customer via a certain service rather than a specifc despatch method
Typcically service levels might be 'Next Day', 'Saturday AM', 'Named Day' and specify the service required rather than an actual carrier
The service level is an optional field when creating an order

Request Information

URI Parameters

None.

Body Parameters

Params
NameDescriptionTypeAdditional information
apiKey

Please contact Caliq support to get your key

string

Required

Max length: 30

Request Formats

application/json, text/json

Sample:
{
  "apiKey": "sample string 1"
}

application/xml, text/xml

Sample:
<Params xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <apiKey>sample string 1</apiKey>
</Params>

Response Information

Resource Description

Returns:
200 OK Returns a list of active service levels as XML or JSON
400 Bad Request - parameters supplied cannot be properly interpreted
401 Not Authorised if supplied api key is not valid
204 No Content if there are no matching records in Caliq
503 Service Unavailable

ServiceLevels
NameDescriptionTypeAdditional information
ServiceLevelList

Collection of ServiceLevel

None.

Response Formats

application/json, text/json

Sample:
{
  "ServiceLevelList": [
    {
      "ID": 64,
      "Description": "sample string 2"
    },
    {
      "ID": 64,
      "Description": "sample string 2"
    }
  ]
}

application/xml, text/xml

Sample:
<ServiceLevels xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Level>
    <ID>64</ID>
    <Description>sample string 2</Description>
  </Level>
  <Level>
    <ID>64</ID>
    <Description>sample string 2</Description>
  </Level>
</ServiceLevels>