Skip to main content
Skip table of contents

[GET] Get promotion data

Request Description

CODE
GET /v1/promotion/[promotion id]

The request allows you to get the data of the promotion.

Connection Data

URL Parameters

[promotion id]

required

Promotion identifier
You can get it from:

Example: /v1/promotion/123456

Header Parameters

AuthorizationJWT

required

Authorization token

  • Format: Bearer [token]

  • Where [token] is substituted by the token, value obtained through the authentication API

Request Example

CODE
GET https://api.ecommerce.noventiq.com/v1/promotion/123456

Response Description

In response to the request, you receive the server response code corresponding to the processing result. Depending on the code, the response body may contain additional parameters.

Successful Response

If processing is successful, the following will return in response:

  • Server response code: HTTP/1.1 200 ОК

  • Response body: promotion data in JSON format

Body Parameters

id

number

required

Promotion identifier

[...]

required

Promotion data
The list and the format of the parameters is the same as in the request for creating promotions. If any of the parameters is optional or is not filled in when creating/editing a promotion, it is filled in with the default value. With the exception of:

  • coupons.coupon_type - if the parameter was not filled in for a promotion earlier, it does not return in response to the request for getting promotion data. In this case, promotion codes have the reusable type reusable.

update_date

string

required

Promotion latest update date

Format: YYYY-MM-DDThh:mm:ss±hh:mm.

Example of Successful Response

CODE
{
 "id": 36,
 "promotion_type": "coupon",
 "promotion_name": "Black Friday",
 "status": true,
 "date_from": "2022-04-08T12:53:02+03:00",
 "date_to": "3000-01-01T00:00:00+03:00",
 "update_date": "2022-11-01T12:53:02+03:00",
 "coupons": {
  "coupon_type": "one-time",
  "coupon_code": [
   "PROMO-001",
   "PROMO-002"
  ],
  "discount_percent": "10",
  "product_id": [
   11111
  ]
 },
 "update_date": "2022-04-08T12:53:02+03:00"
}

Error Response

If an error occurs while processing the request, you receive a server response code corresponding to the result of processing.

Depending on the code, the response body may contain additional parameters.

HTTP Server Response Error Code

HTTP code

Description

HTTP/1.1 400 Bad Request

The request is not valid (error in parameters; necessary data is not transferred, etc.).
An additional error code (one or more) will be transferred in the response bodу.

HTTP/1.1 401 Unauthorized

Unsuccessful authorization.
An additional error code (one or more) will be transferred in the response bodу.

HTTP/1.1 404 Not found

Invalid request URL or no promotion having the identifier transferred is found. If no promotion is found, an additional additional error code will return in the response body. 

HTTP/1.1 500 Request Error

Internal Server Error. Please try again later or contact support.

Additional Error Codes for HTTP 400

Error

Message

Description

11000

No access to promotion management. Please contact technical support.

During processing, we could not identify your account setting unambiguously. Please contact support team.

Additional Error Codes for HTTP 401

The errors are the same for all the APIs that use token authorization.

Additional Error Codes for HTTP 404

Error

Message

Description

11200

Promotion not found: [promotion id]

No promotion with the identifier transferred is found, or you do not have the rights to get the data. 

Body Parameters

errors

array [objects]

required

Error list

errors / [error object] / error

number

required

Error code

errors / [error object] / message

string

Error description

Example of Error Response

CODE
{
 "errors": [{
   "error": 11200,
   "message": "Promotion not found: 123"
  }
 ]
}

Noventiq Checkout

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.