API docs by Redocly

Allegro REST API - Flexible bundles (latest)

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

Flexible bundles test swagger

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"
}