Channels
Get Channel Listings
GET /stores/{store_hash}/v3/channels/{channel_id}/listings
Request
Returns a list of all Channel Listings for a specific channel. Note that if the Channel is not found or there is no listing associated to the Channel, it will return a 200 response with empty data.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- limit in query - integer
Controls the number of items per page for paginated responses.
- after in query - integer
Specifies the prior listing ID in a limited (paginated) list of listings.
- product_id:in in query - array
Filter items by a comma-separated list of product IDs.
Type: array[integer] - date_created in query - string
Filter items by date_created. For example,
date_created=2019-09-04T00:00:00
,date_created=2019-09-04
, ordate_created=1567573200
- date_created:min in query - string
Filter items by minimum date_created. For example,
date_created:min=2019-09-04T00:00:00
,date_created:min=2019-09-04
, ordate_created:min=1567573200
- date_created:max in query - string
Filter items by maximum date_created. For example,
date_created:max=2019-09-04T00:00:00
,date_created:max=2019-09-04
, ordate_created:max=1567573200
- date_modified in query - string
Filter items by date_modified. For example,
date_modified=2019-09-04T00:00:00
,date_modified=2019-09-04
, ordate_modified=1567573200
- date_modified:min in query - string
Filter items by minimum date_modified. For example,
date_modified:min=2019-09-04T00:00:00
,date_modified:min=2019-09-04
, ordate_modified:min=1567573200
- date_modified:max in query - string
Filter items by maximum date_modified. For example,
date_modified:max=2019-09-04T00:00:00
,date_modified:max=2019-09-04
, ordate_modified:max=1567573200
example
Response
Body
dataarray[object]
metaobject
Data about the response, including pagination.
Single Listing
Multiple Listings
Create Channel Listings
POST /stores/{store_hash}/v3/channels/{channel_id}/listings
Request
Creates one or more Channel Listings for a specific channel.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- Content-Type in header with default of application/json - stringrequired
The MIME type of the request body.
Body
product_idinteger
requiredThe ID of the product associated with this channel listing.
external_idstring
Associated ID within a system / platform outside of BC.
statestring
requiredThe state of the product assignment or channel listing.
Allowed: active | disabled | error | pending | pending_disable | pending_delete | partially_rejected | queued | rejected | submitted | deleted
namestring
Name of the product for this channel listing specifically. This is an optional field that can be used to override the product name in the catalog.
descriptionstring
Description of the product for this channel listing specifically. This is an optional field that can be used to override the product description in the catalog.
variantsarray[object]
required
Create Single Listing
Create Multiple Listings
Response
Body
dataarray[object]
metaobject
Data about the response, including pagination.
Single Listing
Multiple Listings
Update Channel Listings
PUT /stores/{store_hash}/v3/channels/{channel_id}/listings
Request
Updates one or more Channel Listings for a specific channel.
Note
- Partial updates are supported. In most cases, if a field that cannot be updated is passed in, the API will not respond with an error. It returns a 200 response with the object, in which you will see the field(s) were not updated.
- If a new variant is provided, the API will append the variant to the list. If a variant already exists, the API will update the existing variant. Other variants that are not provided in the payload remains unchanged.
- If
listing_id
does not exist, the API will return a 200 response with empty data. listing_id
is required and cannot be less than or equal to zero.product_id
cannot be updated after a channel listing is created.product_id
of a variant must match theproduct_id
of the channel listing.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- Content-Type in header with default of application/json - stringrequired
The MIME type of the request body.
Body
listing_idinteger
requiredThe ID of the channel listing that has been created, returned, or updated. In a 422 error, you may receive a response that references the
group_id
. Thegroup_id
in the Invalid Listing ID example refers to thelisting_id
. Please uselisting_id
instead ofgroup_id
in the request payload.Min: 1product_idinteger
requiredThe ID of the product associated with this channel listing.
external_idstring
Associated ID within a system / platform outside of BC.
statestring
requiredThe state of the product assignment or channel listing.
Allowed: active | disabled | error | pending | pending_disable | pending_delete | partially_rejected | queued | rejected | submitted | deleted
namestring
Name of the product for this channel listing specifically. This is an optional field that can be used to override the product name in the catalog.
descriptionstring
Description of the product for this channel listing specifically. This is an optional field that can be used to override the product description in the catalog.
variantsarray[object]
required
Update Single Listing
Update Multiple Listings
Response
Body
dataarray[object]
metaobject
Data about the response, including pagination.
Single Listing
Multiple Listings
Get a Channel Listing
GET /stores/{store_hash}/v3/channels/{channel_id}/listings/{listing_id}
Request
Returns a Channel Listing for a specific channel.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- Accept in header with default of application/json - stringrequired
The MIME type of the response body.
- channel_id in path - integerrequired
The ID of a channel.
- listing_id in path - integerrequired
The ID of a channel listing.
example
Response
Body
dataobject
metaobject
Response metadata.