Checkout & Baskets

Create, update, and retrieve checkout baskets. Includes initiating checkout sessions, renewal checkouts, applying promo codes, updating baskets, and retrieving abandoned baskets.

Update Checkout Basket

put

Update an existing checkout basket with order item actions — add items, remove items, or change quantities. The basket ID is read from the landing state cookie. Returns the updated order and action results.

Required scopes

This endpoint requires the following scopes:

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Header parameters

CookiestringRequired

Landing state cookie containing the basketId.

Body

application/json

Responses

200

Basket updated successfully.

application/json

idstringRequired

The basket ID.

orderobjectRequired

The updated order.

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

Basket not found in landing state.

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

put

/checkout/update

HTTPcURLJavaScriptPython

PUT /api/checkout/update HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Cookie: text
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "orderActions": [
    {
      "orderItemActionType": "add",
      "offerId": "text",
      "orderItemId": "text",
      "quantity": 1,
      "version": "text",
      "parentId": "text"
    }
  ]
}

{
  "id": "text",
  "order": {},
  "orderActionResults": [
    {
      "id": "text",
      "actionType": "add"
    }
  ]
}

Get Abandoned Baskets

get

This API allows you to get a list of abandoned baskets in Limio and filter the results by the date the basket was created. An abandoned basket is one where a basket was started on the Limio checkout but the order was never completed.

You can use the Abandoned Baskets API for actions such as:

• Obtaining marketing information on customers who have abandoned their checkout.

• Gathering information that can be used to remarket to abandoned checkout customers.

• Understanding customer behaviour.

• Tracking abandoned checkouts over time.

• Viewing abandoned checkout items.

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Query parameters

limitintegerRequired

Maximum number of objects to return. Defaults to 50 if not specified.

Default: 50Example: 10

createdAfterstring · date-timeRequired

Filter items created after the provided ISO date-time string

Example: 2020-12-01T16:00:00Z

queryMorestringOptional

Retrieves the next page of results. Use the queryMore returned in the previous response.

Example: DnF1ZXJ5VGhlbkZldGNoBQAAAAAAGH

Responses

200

OK

application/json

queryMorestringOptional

Cursor for the next page of results

Example: eyJ2IjoiMSIsImMiOiJjYjY0ZDY1YS1iYzQwLTQ3YjItODI5Ny1mN2E4ZGEyYjA0M2UiLCJyIjoiMjAyNC0wMy0yNlQxNTowNDo1NC45NzVaIn0=

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

get

/checkout/abandoned

HTTPcURLJavaScriptPython

GET /api/checkout/abandoned?limit=10&createdAfter=2020-12-01T16%3A00%3A00Z HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "basket-8cf72b2a-eb57-462d-8e55-981c3b5e5364",
      "created": "2024-03-26T15:44:54.975Z",
      "customerDetails": {
        "email": "[email protected]",
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Limio LLC"
      },
      "orderItems": [
        {
          "name": "The Offer",
          "path": "/offers2/The Offer",
          "products": [
            {
              "path": "/products/Digital All Access",
              "productCode": "SKU-00000001"
            }
          ]
        }
      ],
      "customFields": {
        "customFieldName": "value"
      },
      "tracking": {
        "offers": [
          "/offers2/UK Annual digital",
          "/offers2/UK Monthly digital"
        ]
      },
      "identities": [
        {
          "sub": "[email protected]",
          "iss": "https://issuer.domain",
          "service": "salesforce",
          "type": "account"
        }
      ],
      "entry": "/checkout",
      "completed": false,
      "recoveryLink": "/api/checkout/recover?basket=basket-8cf72b2a-eb57-462d-8e55-981c3b5e5364&recover=abc123"
    }
  ],
  "queryMore": "eyJ2IjoiMSIsImMiOiJjYjY0ZDY1YS1iYzQwLTQ3YjItODI5Ny1mN2E4ZGEyYjA0M2UiLCJyIjoiMjAyNC0wMy0yNlQxNTowNDo1NC45NzVaIn0="
}

Retrieve existing subscription checkout basket

get

Fetch existing basket by basketId from landing state cookie. Used to retrieve current checkout state after page refresh or navigation.

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Header parameters

CookiestringRequired

Landing state cookie containing basketId

Responses

200

Basket retrieved successfully

application/json

completedbooleanOptional

Whether the checkout is completed

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

No basket found in landing state

application/json

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

get

/checkout/subscription

HTTPcURLJavaScriptPython

GET /api/checkout/subscription HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Cookie: text
Accept: */*

{
  "order": {
    "checkoutId": "basket-12345-uuid",
    "external_id": "text",
    "order_type": "update_subscription",
    "forSubscription": {
      "id": "text",
      "name": "text"
    },
    "forSubscriptionOffer": {
      "offerId": "text"
    },
    "orderItems": [
      {
        "id": "text",
        "orderItemActionType": "add",
        "type": "offer",
        "offerId": "text",
        "quantity": 1,
        "price": {},
        "orderLineItem": {},
        "effective_date": "2026-03-21T09:48:15.674Z"
      }
    ],
    "country": "US",
    "source": "shop",
    "effectiveDate": "2026-03-21T09:48:15.674Z",
    "total": {
      "currency": "USD",
      "orderSubtotal": 1,
      "orderTotal": 1,
      "totalOrderDiscounts": 1,
      "amount": 1
    }
  },
  "nextActions": {
    "upgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "downgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "crossSells": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "subscriptionAddOns": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "selectOffer": true
  },
  "completed": true,
  "context": {
    "client_ip": "text",
    "requestId": "text",
    "identity_id": "text"
  },
  "journey": {
    "referrer": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Initiate update subscription checkout

post

Create a new basket for update subscription with available upgrade/downgrade options. This is the first step in updating a subscription - it creates a basket and returns available actions.

Returns:

• Checkout & Baskets with available upgrades, downgrades, cross-sells, and add-ons

• Sets landing state cookie with basketId for subsequent requests

Status 423: Subscription has pending change (locked until date passes)

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Header parameters

X-Limio-RecaptchastringRequired

reCAPTCHA token for bot prevention

X-Forwarded-ForstringOptional

Client IP address

RefererstringOptional

Referrer URL for journey tracking

Body

application/json

trackingobjectOptional

Optional tracking data for analytics and reporting

Responses

200

Checkout basket created successfully

application/json

400

Invalid request body or missing required fields

application/json

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

Subscription not found

application/json

423

Subscription has pending change, checkout locked

application/json

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

post

/checkout/subscription

HTTPcURLJavaScriptPython

POST /api/checkout/subscription HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Limio-Recaptcha: text
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "order": {
    "external_id": "ext-12345",
    "forSubscription": {
      "id": "sub_abc123"
    },
    "order_type": "update_subscription"
  }
}

Basic subscription checkout initiationInitiate by subscription nameWith tracking and external IDPre-select target offer

{
  "order": {
    "checkoutId": "basket-12345-uuid",
    "external_id": "text",
    "order_type": "update_subscription",
    "forSubscription": {
      "id": "text",
      "name": "text"
    },
    "forSubscriptionOffer": {
      "offerId": "text"
    },
    "orderItems": [
      {
        "id": "text",
        "orderItemActionType": "add",
        "type": "offer",
        "offerId": "text",
        "quantity": 1,
        "price": {},
        "orderLineItem": {},
        "effective_date": "2026-03-21T09:48:15.674Z"
      }
    ],
    "country": "US",
    "source": "shop",
    "effectiveDate": "2026-03-21T09:48:15.674Z",
    "total": {
      "currency": "USD",
      "orderSubtotal": 1,
      "orderTotal": 1,
      "totalOrderDiscounts": 1,
      "amount": 1
    }
  },
  "nextActions": {
    "upgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "downgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "crossSells": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "subscriptionAddOns": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "selectOffer": true
  },
  "completed": true,
  "context": {
    "client_ip": "text",
    "requestId": "text",
    "identity_id": "text"
  },
  "journey": {
    "referrer": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Update subscription checkout basket

put

Update existing basket with order items (add/remove offers and add-ons).

Business Logic:

• Only 1 add offer allowed per request

• System auto-adds remove action for current subscription offer when adding new offer

• System auto-removes incompatible add-ons when switching subscription offers

• System calculates prices, line items, and effective dates

• Cross-sells are recalculated based on updated basket

Requirements:

• basketId must be present in landing state cookie (from POST response)

• Checkout & Baskets must belong to authenticated user

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Header parameters

X-Limio-RecaptchastringRequired

reCAPTCHA token for bot prevention

CookiestringRequired

Landing state cookie containing basketId

Body

application/json

Responses

200

Basket updated successfully

application/json

completedbooleanOptional

Whether the checkout is completed

400

Invalid request or multiple add offers provided

application/json

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

Basket not found in landing state

application/json

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

put

/checkout/subscription

HTTPcURLJavaScriptPython

PUT /api/checkout/subscription HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Limio-Recaptcha: text
Cookie: text
Content-Type: application/json
Accept: */*
Content-Length: 190

{
  "order": {
    "forSubscription": {
      "id": "sub_abc123"
    },
    "order_type": "update_subscription",
    "orderItems": [
      {
        "orderItemActionType": "add",
        "type": "offer",
        "offerId": "offer_premium_annual",
        "quantity": 1
      }
    ]
  }
}

Upgrade to premium subscriptionAdd subscription add-onAdd multiple add-ons

{
  "order": {
    "checkoutId": "basket-12345-uuid",
    "external_id": "text",
    "order_type": "update_subscription",
    "forSubscription": {
      "id": "text",
      "name": "text"
    },
    "forSubscriptionOffer": {
      "offerId": "text"
    },
    "orderItems": [
      {
        "id": "text",
        "orderItemActionType": "add",
        "type": "offer",
        "offerId": "text",
        "quantity": 1,
        "price": {},
        "orderLineItem": {},
        "effective_date": "2026-03-21T09:48:15.674Z"
      }
    ],
    "country": "US",
    "source": "shop",
    "effectiveDate": "2026-03-21T09:48:15.674Z",
    "total": {
      "currency": "USD",
      "orderSubtotal": 1,
      "orderTotal": 1,
      "totalOrderDiscounts": 1,
      "amount": 1
    }
  },
  "nextActions": {
    "upgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "downgrades": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "crossSells": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "subscriptionAddOns": [
      {
        "id": "offer_premium_monthly",
        "name": "Premium Monthly Plan",
        "description": "text",
        "price": {
          "currency": "USD",
          "amount": 29.99
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    ],
    "selectOffer": true
  },
  "completed": true,
  "context": {
    "client_ip": "text",
    "requestId": "text",
    "identity_id": "text"
  },
  "journey": {
    "referrer": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Create Checkout Session

post

Create a basket on behalf of a customer. Used for server-side checkout flows, assisted sales, and programmatic order initiation. Returns a recovery link for the customer to resume the checkout, and optionally an assisted checkout link when the basket has an owner.

Required scopes

This endpoint requires the following scopes:

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Body

application/json

Create a new basket

Responses

200

Admin checkout session created successfully.

application/json

idstringRequired

The unique ID of the created basket.

Example: basket-a1b2c3d4e5f6

recoveryLinkstringRequired

URL path for the customer to recover and resume this checkout session. Includes a signed token valid for 30 days.

Example: /api/checkout/recover?basketId=basket-a1b2c3d4e5f6&recover=eyJ...

assistedCheckoutLinkstringOptional

URL path for assisted checkout (on-behalf-of flow). Only present when the basket has an identified owner. Includes a signed token valid for 30 days.

Example: /api/checkout/assisted?basketId=basket-a1b2c3d4e5f6&cl=eyJ...

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

post

/admin/checkout/initiate

HTTPcURLJavaScriptPython

POST /api/admin/checkout/initiate HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 542

{
  "order": {
    "orderItems": [
      {
        "offer": {
          "id": "8a512ee55befaea0f7fa962cea9982d0e84f0098",
          "version": "4dd34671f26fdbbf240560b78f7f2f54654cde72"
        },
        "quantity": 1
      }
    ],
    "external_id": "1234567890",
    "tracking": {
      "offers": [
        "/offers2/$75 for 52 weeks then $31.96 every 4 weeks autorenew"
      ],
      "purchaseCountryCode": "GB",
      "accountId": "0017x00000Q9O9qAAF",
      "contactId": "0037x00000F58M9AAJ",
      "userId": "0057x0000088Oh3AAE"
    },
    "country": "GB",
    "source": "shop",
    "order_type": "new"
  },
  "journey": {
    "checkout": "/custom-checkout"
  },
  "expiresAfter": {
    "seconds": 1,
    "minutes": 1,
    "hours": 1,
    "days": 1
  }
}

{
  "id": "basket-a1b2c3d4e5f6",
  "recoveryLink": "/api/checkout/recover?basketId=basket-a1b2c3d4e5f6&recover=eyJ...",
  "assistedCheckoutLink": "/api/checkout/assisted?basketId=basket-a1b2c3d4e5f6&cl=eyJ...",
  "order": {
    "orderItems": [
      {}
    ],
    "total": {},
    "orderVersion": "text"
  }
}

Create Renewal Checkout Session

post

Create a checkout session for renewing an existing subscription. Looks up the subscription by ID or reference, retrieves the customer's renewal details, and creates a basket pre-populated with the renewal context.

Required scopes

This endpoint requires the following scopes:

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Body

application/json

Responses

200

Renewal checkout session created successfully.

application/json

idstringRequired

The unique ID of the created renewal basket.

Example: basket-a1b2c3d4e5f6

segmentsstring[]Optional

Customer segments applicable to the renewal.

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

Subscription not found for renewal.

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

post

/admin/checkout/initiate/renew

HTTPcURLJavaScriptPython

POST /api/admin/checkout/initiate/renew HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 225

{
  "order": {
    "external_id": "renewal-2024-001",
    "subId": "text",
    "subRef": "text",
    "order_type": "renew",
    "verify": {
      "customerDetails": {
        "email": "[email protected]"
      },
      "address": {}
    }
  },
  "expiresAfter": {
    "seconds": 1,
    "minutes": 1,
    "hours": 1,
    "days": 1
  }
}

{
  "id": "basket-a1b2c3d4e5f6",
  "segments": [
    "text"
  ],
  "order": {
    "external_id": "text",
    "order_type": "renew",
    "subId": "text",
    "subRef": "text",
    "customerDetails": {
      "firstName": "text",
      "lastName": "text",
      "email": "text"
    },
    "country": "text",
    "renewalDetails": {
      "subscription": {},
      "attributes": {}
    },
    "tracking": {},
    "hideEmailField": true,
    "hidePriceField": true
  }
}

Apply Promo Code to Basket

post

Apply a promotional code to an existing checkout basket. Validates the code, applies applicable discounts, and returns the updated order with recalculated pricing.

Required scopes

This endpoint requires the following scopes:

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth 2.0 Bearer token for authenticated API access. Required for order submission, object management, and administrative operations.

Obtain a token via the OAuth flow described in OAuth Bearer Token.

Pass the token in the Authorization header: Bearer <token>

Body

application/json

codestringRequired

The promotional code to apply.

Example: SUMMER20

basketIdstringRequired

The basket ID to apply the promo code to.

Example: basket-a1b2c3d4e5f6

Responses

200

Promo code applied successfully.

application/json

idstringRequired

The basket ID.

400

Invalid or expired promo code.

401

Unauthorized — the request lacks valid authentication credentials. Verify your Bearer token or API key is correct and has not expired.

application/json

404

Basket not found.

502

Bad Gateway — an upstream service returned an unexpected response. This typically indicates an issue with the request payload (e.g. invalid field values, missing required fields) or a transient infrastructure error. Retry the request, and if the issue persists, verify the request body matches the expected schema.

application/json

post

/admin/v2/promo_code

HTTPcURLJavaScriptPython

POST /api/admin/v2/promo_code HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "code": "SUMMER20",
  "basketId": "basket-a1b2c3d4e5f6"
}

{
  "id": "text",
  "order": {
    "orderItems": [
      {}
    ],
    "orderDiscount": {},
    "total": {},
    "orderVersion": "text"
  }
}