group_id
parameter or a group external reference through the group_external_ref
attribute to filter the list of retrieved listings down.
Do not provide both, as this will result in the request failing.
You must provide either a group_id or group_external_ref, otherwise the request will fail.
Header
The authentication token for your request.
Body
The id of the group of the listings to retrieve.
The external reference of the group of the listings to retrieve.
The external identifier of the listings to retrieve.
The internal identifier of the listings to retrieve.
The API returns a maximum of 100 records per call.You can use this parameter to load the next set of records by passing in the value returned in the response, under
last_id
.Response
The last id in the set of results returned for this API call.You can use this value in the
after-id
parameter to load the next set of results.If there are no more results to load, this value will be -1.The listings retrieved by the endpoint.
Errors
Listed below are common errors that may be returned by the endpoint, along with their corresponding status code. Status Code - 400Missing Authorization header
Expired Authorization header bearer token value
Invalid Authorization header bearer token value
Both group id and external ref provided for the listing find operation
Neither group id nor external ref provided for the listing find operation
Authenticated user does not have access to the requested group
No listing records found for the provided parameters