(Quick Reference) Service: Show

Description: This web service return an existing customer price list record of the specified id in JSON format

Method: GET

URL:

https://BASE_URL/api/VERSION/customerCategories/{id}

Parameters:

NameDescriptionTypeRequiredExample values
idid of the desired objectLongYes777

URL with external_id:

https://BASE_URL/api/VERSION/customerPriceLists/reference/{customerId}/{priceListId}

Parameters:

NameDescriptionTypeRequiredExamples values
customerIdreference of the customerStringYesC-002
priceListIdreference of the price listStringYesPL-001

Success Output

Success case: response.status=200
{
    "id": 137,
    "customerReference": "C-002",
    "priceListReference": "Ref-1",
    "customer": {
        "id": 1335,
        "reference": "C-002",
        "name": "cus2",
        "href": "/api/v1.0/customers/1335"
    },
    "priceList": {
        "id": 1,
        "reference": "Ref-1",
        "name": "Retail price",
        "href": "/api/v1.0/priceLists/1"
    },
    "organization": "Lyon",
    "dateCreated": "2016-08-22T13:08:17Z",
    "lastUpdated": "2016-08-22T13:08:17Z"
}

Failure Output

Failure case:response.status = 404
{
    "error": "not_found",
    "error_description": "The customer price list with the id 999 doesn't exist."
}

Failure case:response.status = 400
{
    "error": "invalid_param_type",
    "error_description": "The type of parameter id you provided is not valid for this request."
}