Get promotion by code for terminal basket

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.enjovia.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Enjovia API MCP server": {
    "url": "https://docs.enjovia.com/mcp"
  }
}

POST /terminal/basket/promotion/code

Bearer auth

Requires process_offline_payments, process_card_payments, or process_test_orders permission

Headers

Store-Subdomain string Required

Store subdomain for store-specific operations

application/json

Body Required

code string Required

Minimum length is 1, maximum length is 191.

Responses

200 application/json

Promotion details
Hide response attribute Show response attribute object
- data object
  
  Hide data attributes Show data attributes object
  
  id string(uuid)
  
  code string
  
  name string
  
  type string
  
  value number
404

Promotion not found
422

Invalid code

POST /terminal/basket/promotion/code

curl \
 --request POST 'https://api.gb.enjovia.app/terminal/basket/promotion/code' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "Store-Subdomain: string" \
 --data '{
  "code": "string"
}'

Request examples

# Headers
Store-Subdomain: string

# Payload
{
  "code": "string"
}

Response examples (200)

{
  "data": {
    "id": "string",
    "code": "string",
    "name": "string",
    "type": "string",
    "value": 42.0
  }
}