Banners
Get All Banners
GET https://api.bigcommerce.com/stores/{store_hash}/v2/bannersRequest
Returns a list of Banners. Default sorting is by banner id, from lowest to highest.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- min_id in query - integer
Optional filter param
/api/v2/banners?min_id={value}
- max_id in query - integer
Optional filter param
/api/v2/banners?max_id={value}
- page in query - number
Optional filter param
/api/v2/banners?page={number}
- limit in query - number
Optional filter param
/api/v2/banners?limit={count}
example
Response
Body
example
Create a Banner
POST https://api.bigcommerce.com/stores/{store_hash}/v2/bannersRequest
Creates a Banner.
Required Fields
- name
- content
- page
- location
- date_type
Read Only Fields
- date_created
- id
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
Body
namestring
requiredName of the banner.
Example: Sale Bannercontentstring
requiredContains the banner content. Returned as a string and includes HTML formatting.
Example: <p> Sale! Tuesday at 9am! </p>pagestring
requiredPage the Banner is located on.
Allowed: home_page | category_page | brand_page | search_page
locationstring
requiredLocation on the page.
Allowed: top | bottom
Example: topdate_typestring
requiredThis specifies whether the banner should be visible during a specific date range.
Allowed: always | custom
date_fromstring
If the datetype is set as 'custom’, this field specifies the date when the banner should become visible on the storefront.
Example: 0date_tostring
If the datetype is set as 'custom’, this field specifies the date when the banner should stop being visible on the storefront.
Example: 0visiblestring
Integer value denoting whether or not the banner is visible on the storefront: 1 = visible; 0 = not visible
Example: 1item_idstring
If the banner is on a specific category or brand page, then the item_id will correspond the category or brand ID.
Example: 35
example
Response
Body
example
Delete All Banners
DELETE https://api.bigcommerce.com/stores/{store_hash}/v2/bannersRequest
By default, it deletes all Banners.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
example
Response
Get a Banner
GET https://api.bigcommerce.com/stores/{store_hash}/v2/banners/{id}Request
Returns a single Banner
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the banner.
example
Response
Body
example
Update a Banner
PUT https://api.bigcommerce.com/stores/{store_hash}/v2/banners/{id}Request
Updates a Banner.
Read Only Fields
- date_created
- id
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the banner.
Body
example
Response
Body
example
Delete a Banner
DELETE https://api.bigcommerce.com/stores/{store_hash}/v2/banners/{id}Request
Deletes a Banner.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the banner.
example
Response
Get a Count of Store Banners
GET https://api.bigcommerce.com/stores/{store_hash}/v2/banners/countRequest
Returns a count of Banners.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
example
Response
Body
countinteger