API docs by Redocly

Allegro REST API - Flexible bundles (latest)

URL: https://github.com/allegro/allegro-api/issues Terms of Service

Overview

This API is only available in Allegro public testing environment (Sandbox).

It will be implemented in production in the second half of April 2026, replacing endpoints from the /sale/bundles path.

You can read more in our news:

PL / EN.

Flexible bundles

Create new flexible bundle

You can create flexible bundle using this resource.
Requirements:

  • there are max 6 slots in bundle;
  • slots order must be unique;
  • each slot can contain up to 30 offers;
  • all offers in slot must be from the same category leaf (based on assortment's tree);
  • at least one slot has to be marked as entrypoint;
  • offer can be used in bundle only once (cannot be used in multiple slots);
  • only offers active on at least one marketplace can be used;
  • B2B offers cannot be used;
  • age-restricted offers (eg. alcohol) cannot be used;
  • cannot use multiple offers which are representing same product.
.

Authorizations:
bearer-token-for-user
Request Body schema: application/vnd.allegro.public.v1+json
required
Array of objects (FlexibleBundleSlotDTO) [ 2 .. 6 ] items
object or null

Discount configuration for bundle

Responses

Request samples

Content type
application/vnd.allegro.public.v1+json
Example
{
  • "slots": [
    ],
  • "discount": null
}

Response samples

Content type
application/vnd.allegro.public.v1+json
Example
{
  • "id": "bac2128a-ec95-4d19-a241-d8be7001b8b8",
  • "createdAt": "2025-09-21T10:22:02.999Z",
  • "createdBy": "USER",
  • "slots": [
    ],
  • "discount": null
}

List seller's flexible bundles

You can fetch page of seller's flexible bundles using this endpoint.
Paging:
To move to next page, specify page.id parameter with value obtained in response from previous request. Number of offer bundles on single page can be specified using limit parameter.
Filtering:
Offer bundles can be filtered to bundles which contain offer specified in offer.id parameter.

Authorizations:
bearer-token-for-user
query Parameters
limit
integer <int32> [ 1 .. 1000 ]
Default: 20
Example: limit=200

Limit of bundles per page.

offer.id
string
Example: offer.id=123456789

Filter bundles which contains offer.

page.id
string
Example: page.id=MjAyNC0wOS0xMFQwNjo0OTowMi40NTBa

ID of page which will be retrieved.

Responses

Response samples

Content type
application/vnd.allegro.public.v1+json
{
  • "bundles": [
    ],
  • "nextPage": {
    }
}

Get flexible bundle by ID

Use this resource to retrieve flexible bundle by its unique identifier.

Authorizations:
bearer-token-for-user
path Parameters
bundleId
required
string <uuid>

Bundle ID.

Responses

Response samples

Content type
application/vnd.allegro.public.v1+json
Example
{
  • "id": "bac2128a-ec95-4d19-a241-d8be7001b8b8",
  • "createdAt": "2025-09-21T10:22:02.999Z",
  • "createdBy": "ALLEGRO",
  • "slots": [
    ],
  • "discount": null
}

Updates flexible bundle

You can update flexible bundle using this resource.
Requirements:

  • there are max 6 slots in bundle;
  • slots order must be unique;
  • each slot can contain up to 30 offers;
  • all offers in slot must be from the same category leaf (based on assortment's tree);
  • at least one slot has to be marked as entrypoint;
  • offer can be used in bundle only once (cannot be used in multiple slots);
  • only offers active on at least one marketplace can be used;
  • B2B offers cannot be used;
  • age-restricted offers (eg. alcohol) cannot be used;
  • cannot use multiple offers which are representing same product.
.

Authorizations:
bearer-token-for-user
path Parameters
bundleId
required
string <uuid>

Bundle ID.

Request Body schema: application/vnd.allegro.public.v1+json
required
Array of objects (FlexibleBundleSlotDTO) [ 2 .. 6 ] items
object or null (FlexibleBundleDiscountDTO)

Discount configuration for bundle

Responses

Request samples

Content type
application/vnd.allegro.public.v1+json
Example
{
  • "slots": [
    ],
  • "discount": null
}

Response samples

Content type
application/vnd.allegro.public.v1+json
Example
{
  • "id": "bac2128a-ec95-4d19-a241-d8be7001b8b8",
  • "createdAt": "2025-09-21T10:22:02.999Z",
  • "createdBy": "ALLEGRO",
  • "slots": [
    ],
  • "discount": null
}

Delete flexible bundle by ID

Use this resource to delete flexible bundle by its unique identifier.

Authorizations:
bearer-token-for-user
path Parameters
bundleId
required
string <uuid>

Bundle ID.

Responses

Response samples

Content type
application/vnd.allegro.public.v1+json
{
  • "error": "unauthorized",
  • "error_description": "Full authentication is required to access this resource"
}