(Quick Reference) Service: Show

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

Method: GET

URL:

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

Parameters:

NameDescriptionTypeRequiredExample values
idid of the desired objectLongYes777

URL with external_id:

https://BASE_URL/api/VERSION/customerPromotionLists/reference/{customerId}/{promotionListId}

Parameters:

NameDescriptionTypeRequiredExamples values
customerIdreference of the customerStringYesC-002
promotionListIdreference of the promotion listStringYesPL-001

Success Output

Success case: response.status=200
{
    "id": 305,
    "customerReference": "C-002",
    "promotionListReference": "RP-001",
    "customer": {
        "id": 1335,
        "reference": "C-002",
        "name": "cus2",
        "href": "/api/v1.0/customers/1335"
    },
    "promotionList": {
        "id": 9,
        "reference": "RP-001",
        "href": "/api/v1.0/promotionLists/9"
    },
    "organization": "Lyon",
    "dateCreated": "2016-08-22T14:43:17Z",
    "lastUpdated": "2016-08-22T14:43:17Z"
}

Failure Output

Failure case:response.status = 404
{
    "error": "not_found",
    "error_description": "The customer promotion 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."
}