The BeezUP Merchant API offers programmatic access to the platform’s core features, including catalog management (importations, auto‑import configuration, custom columns), analytics and reporting (product, category, channel, day reports with filters and rule‑based optimisations), click/order tracking, and marketplace order operations (harvest, history, batch updates, and synchronization status).
Send a batch of operations to change your marketplace Order information: accept, ship, etc. (max 100 items per call)
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
POST
/orders/v3/batches/changeOrders/{changeOrderType}
Send a batch of operations to change your marketplace Order information: accept, ship, etc. (max 100 items per call)
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
changeOrderType(path, required) — The Order change type
POST
/orders/v3/batches/clearMerchantOrderInfos
Send a batch of operations to clear an Order's merchant information (max 100 items per call)
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
POST
/orders/v3/batches/setMerchantOrderInfos
Send a batch of operations to set an Order's merchant information (max 100 items per call)
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
POST
/orders/v3/harvest
Send harvest request to all your marketplaces
storeId(query) — The StoreId to filter by
POST
/orders/v3/list/full
Get a paginated list of all Orders with all Order and Order Item(s) properties
Accept-Encoding(header, required) — Allows the client to indicate wether it accepts a compressed encoding to reduce traffic size
POST
/orders/v3/list/light
Get a paginated list of all Orders without details
Get the list of MarketplaceBusinessCode ready for Order Management
Accept-Language(header) — Indicates that the client accepts the following languages.
storeIds(query) — StoredIds to filter
GET
/orders/v3/status
Get current synchronization status between your marketplaces and BeezUP accounts
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
Get the meta information about the order (ETag, Last-Modified)
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
Change your marketplace Order Information (accept, ship, etc.)
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
changeOrderType(path, required) — The Order change type
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
GET
/v2/public/channels/
Get public channel index
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/public/channels/{countryIsoCode}
The channel list for one country
countryIsoCode(path, required) — The country iso code alpha 3 based on this: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Decoding_table \ To know which country are available you have to use the operation: GetChannelsByCountry
Accept-Encoding(header, required) — Allows the client to indicate whether it accepts a compressed encoding to reduce traffic size.
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/public/lov/
Get all list names
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/public/lov/{listName}
Get the list of values related to this list name
listName(path, required) — The list of value name your want to get
Accept-Language(header) — Indicates that the client accepts the following languages.
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/public/security/login
Login
POST
/v2/public/security/lostpassword
Lost password
POST
/v2/public/security/register
User Registration
GET
/v2/user/analytics/
Get the Analytics API operation index
POST
/v2/user/analytics/reports/byday
Get the report by day for a StoreId
GET
/v2/user/analytics/tracking/status
Get the global synchronization status of clicks and orders
GET
/v2/user/analytics/{storeId}
Get the Analytics API operation index for one store
channelCatalogId(path, required) — The channel catalog identifier
GET
/v2/user/channels/
List all available channel for this store
storeId(query, required) — The store identifier
GET
/v2/user/channels/{channelId}
Get channel information
channelId(path, required) — The channel identifier
GET
/v2/user/channels/{channelId}/categories
Get channel categories
channelId(path, required) — The channel identifier
Accept-Encoding(header, required) — Indicates that the client accepts that the response will be compressed to reduce traffic size.
POST
/v2/user/channels/{channelId}/columns
Get channel columns
channelId(path, required) — The channel identifier
Accept-Encoding(header, required) — Indicates that the client accepts that the response will be compressed to reduce traffic size.
GET
/v2/user/customer/
The index of all operations and LOV
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/user/customer/account
Get user account information
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/customer/account/activate
Activate the user account
POST
/v2/user/customer/account/changeEmail
Change user email
POST
/v2/user/customer/account/changePassword
Change user password
PUT
/v2/user/customer/account/companyInfo
Change company information
GET
/v2/user/customer/account/creditCardInfo
Get credit card information
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
PUT
/v2/user/customer/account/creditCardInfo
Save user credit card info
PUT
/v2/user/customer/account/personalInfo
Save user personal information
GET
/v2/user/customer/account/profilePictureInfo
Get profile picture information
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
PUT
/v2/user/customer/account/profilePictureInfo
Change user picture information
POST
/v2/user/customer/account/resendEmailActivation
Resend email activation
GET
/v2/user/customer/billingPeriods
Get billing periods conditions
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/user/customer/contracts
Get contract list
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/user/customer/invoices
Get all your invoices
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/user/customer/offers
Get all standard offers
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/customer/offers
Get offer pricing
POST
/v2/user/customer/security/logout
Log out the current user from go2
GET
/v2/user/customer/stores
Get store list
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/customer/stores
Create a new store
DELETE
/v2/user/customer/stores/{storeId}
Delete a store
storeId(path, required) — Your store identifier
GET
/v2/user/customer/stores/{storeId}
Get store's information
storeId(path, required) — Your store identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
PATCH
/v2/user/customer/stores/{storeId}
Update some store's information.
storeId(path, required) — Your store identifier
GET
/v2/user/customer/stores/{storeId}/alerts
Get store's alerts
storeId(path, required) — Your store identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/customer/stores/{storeId}/alerts
Save store alerts
storeId(path, required) — Your store identifier
GET
/v2/user/customer/stores/{storeId}/rights
Get store's rights
storeId(path, required) — Your store identifier
GET
/v2/user/customer/stores/{storeId}/shares
Get shares related to this store
storeId(path, required) — Your store identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
Get the push reporting related to this subscription
id(path, required)
pageNumber(query, page)
pageSize(query, limit)
GET
/v2/user/lov/{listName}
Get the list of values related to this list name
listName(path, required) — The list of value name your want to get
Accept-Language(header) — Indicates that the client accepts the following languages.
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
Save new marketplace settings for a channel catalog
channelCatalogId(path, required) — Channel Catalog Id to query
GET
/v2/user/marketplaces/orders/
[DEPRECATED] Get all actions you can do on the order API
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
GET
/v2/user/marketplaces/orders/automaticTransitions
Get list of configured automatic Order status transitions
storeId(query) — The StoreId to filter by
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/marketplaces/orders/automaticTransitions
Configure new or existing automatic Order status transition
[DEPRECATED] Send a batch of operations to change your marketplace Order information: accept, ship, etc. (max 100 items per call)
changeOrderType(path, required) — The Order change type
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
pageNumber(query, required, page) — The page number you want to get
pageSize(query, required, limit) — The entry count you want to get
storeId(query, required) — The store identifier to regroup the order exportations
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
POST
/v2/user/marketplaces/orders/exportations
Request a new Order report exportation to be generated
POST
/v2/user/marketplaces/orders/harvest
[DEPRECATED] Send harvest request to all your marketplaces
storeId(query) — The StoreId to filter by
POST
/v2/user/marketplaces/orders/invoices/generate
Generate an Order Invoice batch
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
marketplaceTechnicalCode(path, required) — The Marketplace Technical Code
accountId(path, required) — The Account Identifier
beezUPOrderUUID(path, required) — The BeezUP Order UUID
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
marketplaceTechnicalCode(path, required) — The Marketplace Technical Code
accountId(path, required) — The Account Identifier
beezUPOrderUUID(path, required) — The BeezUP Order UUID
Accept-Encoding(header, required) — Allows the client to indicate wether it accepts a compressed encoding to reduce traffic size
POST
/v2/user/marketplaces/orders/list/full
[DEPRECATED] Get a paginated list of all Orders with all Order and Order Item(s) properties
Accept-Encoding(header, required) — Allows the client to indicate wether it accepts a compressed encoding to reduce traffic size
POST
/v2/user/marketplaces/orders/list/light
[DEPRECATED] Get a paginated list of all Orders without details
GET
/v2/user/marketplaces/orders/status
[DEPRECATED] Get current synchronization status between your marketplaces and BeezUP accounts
storeId(query) — The StoreId to filter by
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
[DEPRECATED] DEPRECATED - Get full Order and Order Item(s) properties
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
[DEPRECATED] DEPRECATED - Get the meta information about the order (ETag, Last-Modified)
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
[DEPRECATED] Get an Order's harvest and change history
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
If-None-Match(header) — ETag value to identify the last known version of requested resource.\ To avoid useless exchange, we recommend you to indicate the ETag you previously got from this operation.\ If the ETag value does not match the response will be 200 to give you a new content, otherwise the response will be: 304 Not Modified, without any content.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
[DEPRECATED] Change your marketplace Order Information (accept, ship, etc.)
marketplaceTechnicalCode(path, required) — The marketplace technical code
accountId(path, required)
beezUPOrderId(path, required) — The BeezUP Order identifier
changeOrderType(path, required) — The Order change type
userName(query, required) — Sometimes the user in the e-commerce application is not the same as user associated with the current subscription key. We recommend providing your application's user login.
testMode(query) — If true, the operation will be not be sent to marketplace. But the validation will be taken in account.
If-Match(header, required) — ETag value to identify the last known version of requested resource.\ To ensure that you are making a change on the lastest version of the resource.\ For more details go to this link: http://tools.ietf.org/html/rfc7232#section-2.3
226 endpoints auto-detected
Authentication
This API uses an API key, passed in the "Ocp-Apim-Subscription-Key" header. No OAuth required.
curl -X POST \
"https://api.beezup.com/v2/user/analytics/{storeId}/reports/byproduct" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"