Allegro REST API

gdzie?
Allegro REST API
Documentation Powered by ReDoc

Allegro REST API (latest)

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

https://developer.allegro.pl/about

Documentation is generated from this OpenAPI 3.0 specification file.

Authentication

bearer-token-for-user

For more information, see https://developer.allegro.pl/auth/#app to read about authorization code flow or https://developer.allegro.pl/auth/#DeviceFlow to read about the device code flow.

Security Scheme Type OAuth2
authorizationCode OAuth Flow
Authorization URL: https://allegro.pl/auth/oauth/authorize
Token URL: https://allegro.pl/auth/oauth/token
Scopes:
    x-deviceCode OAuth Flow
    Scopes:

      bearer-token-for-application

      For more information, see https://developer.allegro.pl/auth/#clientCredentialsFlow

      Security Scheme Type OAuth2
      clientCredentials OAuth Flow
      Token URL: https://allegro.pl/auth/oauth/token
      Scopes:

        User's offer information

        Get all data of the particular product-offer

        Use this resource to retrieve all data of the particular product-offer. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "productSet": [
          ],
        • "category": {
          },
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "additionalMarketplaces": {
          },
        • "b2b": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "validation": {
          },
        • "afterSalesServices": {
          },
        • "discounts": {
          },
        • "stock": {
          },
        • "parameters": [
          ],
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "sizeTable": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "messageToSellerSettings": {
          }
        }

        Get seller's offers

        Use this resource to get the list of the seller's offers. You can use different query parameters to filter the list. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        query Parameters
        offer.id
        string

        Offer ID.

        name
        string

        The text to search in the offer title.

        sellingMode.price.amount.gte
        number >= 0
        Example: sellingMode.price.amount.gte=9.99

        The lower threshold of price.

        If additionally a publication.marketplace is provided, searches using the price on the given marketplace.

        sellingMode.price.amount.lte
        number >= 1
        Example: sellingMode.price.amount.lte=125.99

        The upper threshold of price.

        If additionally a publication.marketplace is provided, searches using the price on the given marketplace.

        publication.status
        Array of strings
        Items Enum: "INACTIVE" "ACTIVE" "ACTIVATING" "ENDED"

        The publication status of the offer. Passing more than one value will search for offers with any of the given statuses. By default all statuses are included. Example: publication.status=INACTIVE&publication.status=ACTIVE - returns offers with status INACTIVE or ACTIVE.

        publication.marketplace
        string (MarketplaceId)
        Enum: "allegro-pl" "allegro-cz"
        Example: publication.marketplace=allegro-pl

        Either the base marketplace or an additional marketplace of the offer.

        When passing the parameter publication.marketplace, searches for offers with the given marketplace as either its base marketplace or one of its additional marketplaces. When the parameter is omitted, searches for offers with all marketplaces.

        In addition to searching, passing the parameter also influences the functionality of other query parameter by searching and sorting by data (e.g. price) on the given marketplace.

        sellingMode.format
        Array of strings
        Items Enum: "BUY_NOW" "ADVERTISEMENT" "AUCTION"

        The offer's selling format. Passing more than one value will search for offers with any of the given formats. By default all formats are included. Example: sellingMode.format=BUY_NOW&sellingMode.format=ADVERTISEMENT - returns offers with with format BUY_NOW or ADVERTISEMENT.

        external.id
        Array of strings <= 100 items [ items <= 100 characters ]

        The ID from the client's external system. Passing more than one value will search for offers with any of the given IDs. By default no ID is included. Example: external.id=1233&external.id=1234 - returns offers with ID 1233 or 1234. Single ID length shouldn't exceed 100 characters.

        delivery.shippingRates.id
        string <uuid>

        The ID of shipping rates. Returns offers with given shipping rates ID.

        delivery.shippingRates.id.empty
        boolean

        Allows to filter offers by existence of shipping rates ID.

        sort
        string
        Enum: "sellingMode.price.amount" "-sellingMode.price.amount" "stock.sold" "-stock.sold" "stock.available" "-stock.available"

        The results' sorting order. No prefix in the value means ascending order. - prefix means descending order. If you don't provide the sort parameter, the list is sorted by offer creation time, descending.

        If additionally a publication.marketplace is provided, sorts by price and stock.sold using the data on the given marketplace.

        limit
        integer <int32> [ 1 .. 1000 ]
        Default: 20

        The maximum number of offers returned in the response.

        offset
        integer <int32> [ 0 .. 9999999 ]

        Index of the first returned offer from all search results. Maximum sum of offset and limit is 10 000 000.

        category.id
        string

        The identifier of the category, where you want to search for offers.

        product.id.empty
        boolean

        Allows to filter offers by existence of product ID.

        productizationRequired
        boolean

        Allows to search for offers from categories where productization is required.

        b2b.buyableOnlyByBusiness
        boolean

        Allows to search for offers buyable only by businesses.

        fundraisingCampaign.id
        string <uuid>

        ID of the charity fundraising campaign that benefits from this offer.

        fundraisingCampaign.id.empty
        boolean

        Allows to search for charity or commercial offers.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offers": [
          ],
        • "count": 1,
        • "totalCount": 1234
        }

        Get all fields of the particular offer Deprecated

        Get all fields of the particular offer. This endpoint is deprecated: PL / EN. Use GET /sale/product-offers/{offerId} instead. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "category": {
          },
        • "additionalMarketplaces": {
          },
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "compatibilityList": {
          },
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "customParameters": [
          ],
        • "delivery": {
          },
        • "description": {
          },
        • "discounts": {
          },
        • "external": {
          },
        • "fundraisingCampaign": {
          },
        • "id": "string",
        • "images": [
          ],
        • "location": {
          },
        • "name": "string",
        • "parameters": [
          ],
        • "payments": {
          },
        • "product": {
          },
        • "promotion": {
          },
        • "publication": {
          },
        • "sellingMode": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Get Smart! classification report of the particular offer

        Use this resource to get a full Smart! offer classification report of one of your offers. Please keep in mind you have to meet Smart! seller conditions first - for more details, use GET /sale/smart. To learn more about Smart! offer requirements, see our knowledge base article: PL / EN. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        query Parameters
        marketplaceId
        string
        Example: marketplaceId=allegro-pl

        Marketplace for which offer classification report will be returned. If not specified, the result of the offer's base marketplace will be returned.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "classification": {
          },
        • "scheduledForReclassification": true,
        • "smartDeliveryMethods": [
          ],
        • "conditions": [
          ]
        }

        Get events about the seller's offers

        Use this endpoint to get events concerning changes in the authorized seller's offers. At present we support the following events:

        • OFFER_ACTIVATED - offer is visible on site and available for purchase, occurs when offer status changes from ACTIVATING to ACTIVE.
        • OFFER_CHANGED - occurs when offer's fields has been changed e.g. description or photos.
        • OFFER_ENDED - offer is no longer available for purchase, occurs when offer status changes from ACTIVE to ENDED.
        • OFFER_STOCK_CHANGED - stock in an offer was changed either via purchase or by seller.
        • OFFER_PRICE_CHANGED - occurs when price in an offer was changed.
        • OFFER_ARCHIVED - offer is no longer available on listing and has been archived.
        • OFFER_BID_PLACED - bid was placed on the offer
        • OFFER_BID_CANCELED - bid for offer was canceled
        • OFFER_TRANSLATION_UPDATED - translation of offer was updated
        • OFFER_VISIBILITY_CHANGED - visibility of offer was changed on marketplaces

        Returned events may occur by actions made via browser or API. The resource allows you to get events concerning active offers and offers scheduled for activation (status ACTIVE and ACTIVATING). Returned events do not concern offers in INACTIVE and ENDED status (the exception is OFFER_ARCHIVED event). External id is returned for all event types except OFFER_BID_PLACED and OFFER_BID_CANCELED. Please note that one change may result in more than one event. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        query Parameters
        from
        string <= 256 characters
        Example: from=MTEzMjQzODU3NA

        The ID of the last seen event. Events that occured after the given event will be returned.

        limit
        integer [ 1 .. 1000 ]
        Default: 100

        The number of events that will be returned in the response.

        type
        Array of strings
        Items Enum: "OFFER_ACTIVATED" "OFFER_CHANGED" "OFFER_ENDED" "OFFER_STOCK_CHANGED" "OFFER_PRICE_CHANGED" "OFFER_ARCHIVED" "OFFER_BID_PLACED" "OFFER_BID_CANCELED" "OFFER_TRANSLATION_UPDATED" "OFFER_VISIBILITY_CHANGED"

        The types of events that will be returned in the response. All types of events are returned by default.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        Example
        offer event
        offer event
        offer ended event
        offer bid placed event
        offer bid canceled event
        offer translation updated event
        offer visibility on marketplaces changed event
        {
        • "id": "MTEzMjQzODU3NA",
        • "occurredAt": "2019-06-26T15:26:43.891Z",
        • "type": "OFFER_ACTIVATED",
        • "offer": {
          }
        }

        Offer management

        Create offer based on product

        Use this resource to create offer based on product. Read more: PL / EN. Note that requests may be limited.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        Request Body schema: application/vnd.allegro.public.v1+json
        Array of objects[ items ]
        object (B2b)

        Defines offer properties for buyers with company account (Allegro Biznes).

        Array of objects (ProductOfferAttachment) [ items ]

        An array of offer attachments.

        object (ProductOfferFundraisingCampaignRequest)
        object (ProductOfferAdditionalServicesRequest)

        Offer additional services.

        required
        object (SaleProductOffersRequestStock)
        object
        object
        object

        Selected information about the offer in each additional service. This field does not contain information about the base marketplace of the offer.
        Possible values of marketplaceId can be obtained from GET /marketplaces resource.
        See Allegro foreign marketplaces for more details regarding this field.

        object

        For the /sale/product-offers resources you can send only definition of the MANUAL compatibility list. If compatibility list is provided for the product assigned to the offer, it will be used automatically.

        language
        string <BCP-47 language code>

        Declared base language of the offer.

        object

        Category in which the offer is listed for sale. You can indicate a category from the product's 'similar categories' to set the offer's category.

        Array of objects (ParameterProductOfferRequest) [ items ]
        object (AfterSalesServicesProductOfferRequest)

        The definitions of the different after sales services assigned to the offer.

        object

        The size table information. You can enter the size tabe identifier or name.

        object

        Identifier of contact data for sales format ADVERTISEMENT (classified ad). You can enter the contact identifier or name.

        object (DiscountsProductOfferRequest)
        name
        string <= 75 characters

        Name (title) of an offer. Length cannot be more than 75 characters. Read more: PL / EN .

        object (Payments)
        object (SellingMode)

        Information on the offer's selling mode.

        object (Location)

        for offer with a delivery method it is a parcel dispatch location. For offers with personal pick-up it is a pick-up location, additionally we recommend to use points of service (https://developer.allegro.pl/documentation/#tag/Points-of-service)

        images
        Array of strings
        object (StandardizedDescription)

        The description section cannot have more than 40000 bytes in length.

        object (ExternalId)

        The information on the offer in an external system.

        object (ExtendedTax)
        Deprecated

        VAT tax settings. Available settings can be found under "get all tax settings for category" resource. This field is deprecated in favor of taxSettings.

        object (OfferTaxSettings)

        Tax settings for offer. Available settings can be found under "get all tax settings for category" resource.

        object (MessageToSellerSettings)

        Defines message to the seller settings options.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "productSet": [
          ],
        • "b2b": {
          },
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "stock": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "additionalMarketplaces": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "category": {
          },
        • "parameters": [
          ],
        • "afterSalesServices": {
          },
        • "sizeTable": {
          },
        • "contact": {
          },
        • "discounts": {
          },
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "messageToSellerSettings": {
          }
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "productSet": [
          ],
        • "category": {
          },
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "additionalMarketplaces": {
          },
        • "b2b": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "validation": {
          },
        • "afterSalesServices": {
          },
        • "discounts": {
          },
        • "stock": {
          },
        • "parameters": [
          ],
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "sizeTable": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "messageToSellerSettings": {
          }
        }

        Edit an offer

        Use this resource to edit offer. Read more: PL / EN. Note that requests may be limited.

        Authorizations:
        bearer-token-for-user
        path Parameters
        offerId
        required
        string

        The offer identifier.

        Request Body schema: application/vnd.allegro.public.v1+json
        Array of objects[ items ]
        object (B2b)

        Defines offer properties for buyers with company account (Allegro Biznes).

        Array of objects (ProductOfferAttachment) [ items ]

        An array of offer attachments.

        object (ProductOfferFundraisingCampaignRequest)
        object (ProductOfferAdditionalServicesRequest)

        Offer additional services.

        object

        For the /sale/product-offers resources you can send only definition of the MANUAL compatibility list. If compatibility list is provided for the product assigned to the offer, it will be used automatically.

        object
        object (SaleProductOffersRequestStock)
        object
        object

        Selected information about the offer in each additional service. This field does not contain information about the base marketplace of the offer.
        Possible values of marketplaceId can be obtained from GET /marketplaces resource.
        See Allegro foreign marketplaces for more details regarding this field.

        language
        string <BCP-47 language code>

        Declared base language of the offer.

        object

        Category in which the offer is listed for sale. You can indicate a category from the product's 'similar categories' to set the offer's category.

        Array of objects (ParameterProductOfferRequest) [ items ]
        object (AfterSalesServicesProductOfferRequest)

        The definitions of the different after sales services assigned to the offer.

        object

        The size table information. You can enter the size tabe identifier or name.

        object

        Identifier of contact data for sales format ADVERTISEMENT (classified ad). You can enter the contact identifier or name.

        object (DiscountsProductOfferRequest)
        name
        string <= 75 characters

        Name (title) of an offer. Length cannot be more than 75 characters. Read more: PL / EN .

        object (Payments)
        object (SellingMode)

        Information on the offer's selling mode.

        object (Location)

        for offer with a delivery method it is a parcel dispatch location. For offers with personal pick-up it is a pick-up location, additionally we recommend to use points of service (https://developer.allegro.pl/documentation/#tag/Points-of-service)

        images
        Array of strings
        object (StandardizedDescription)

        The description section cannot have more than 40000 bytes in length.

        object (ExternalId)

        The information on the offer in an external system.

        object (ExtendedTax)
        Deprecated

        VAT tax settings. Available settings can be found under "get all tax settings for category" resource. This field is deprecated in favor of taxSettings.

        object (OfferTaxSettings)

        Tax settings for offer. Available settings can be found under "get all tax settings for category" resource.

        object (MessageToSellerSettings)

        Defines message to the seller settings options.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "productSet": [
          ],
        • "b2b": {
          },
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "compatibilityList": {
          },
        • "delivery": {
          },
        • "stock": {
          },
        • "publication": {
          },
        • "additionalMarketplaces": {
          },
        • "language": "pl-PL",
        • "category": {
          },
        • "parameters": [
          ],
        • "afterSalesServices": {
          },
        • "sizeTable": {
          },
        • "contact": {
          },
        • "discounts": {
          },
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "messageToSellerSettings": {
          }
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "productSet": [
          ],
        • "category": {
          },
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "additionalMarketplaces": {
          },
        • "b2b": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "validation": {
          },
        • "afterSalesServices": {
          },
        • "discounts": {
          },
        • "stock": {
          },
        • "parameters": [
          ],
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "sizeTable": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "messageToSellerSettings": {
          }
        }

        Check the processing status of a POST or PATCH request

        The URI for the resource given by Location header of POST /sale/product-offers and PATCH /sale/product-offers/{offerId}. Use this resource to check processing status of a POST or PATCH request. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        operationId
        required
        string

        Operation identifier provided in location header of POST or PATCH request.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offer": {
          },
        • "operation": {
          }
        }

        Create a draft offer Deprecated

        Create an offer draft. This endpoint is deprecated: PL / EN. Use POST /sale/product-offers instead. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        Request Body schema: application/vnd.allegro.public.v1+json

        offer

        object

        Category in which the offer is listed for sale. You can indicate a category from the product's 'similar categories' to set the offer's category.

        object (AdditionalMarketplaces)

        Settings for each additional marketplace.

        object (JustId)
        object (AfterSalesServices)

        The definitions of the different after sales services assigned to the offer.

        Array of objects (Attachment) [ items ]

        List of offer attachments. You can attach up to 7 files to the offer – one per each attachment type as described in uploading offer attachments flow.

        object (CompatibilityList)
        object (JustId)
        createdAt
        string <date-time>

        Creation date: Format (ISO 8601) - yyyy-MM-dd'T'HH:mm:ss.SSSZ. Cannot be modified.

        Array of objects (CustomParameter) [ items ]

        List of custom parameters. You can add up to 4 custom parameters, each containing exactly one value.

        object (DeliveryFull)
        object (StandardizedDescription)

        The description section cannot have more than 40000 bytes in length.

        object (Discounts)
        object (ExternalId)

        The information on the offer in an external system.

        object (JustId)
        id
        string
        Array of objects (ImageUrl) [ items ]
        object (Location)

        for offer with a delivery method it is a parcel dispatch location. For offers with personal pick-up it is a pick-up location, additionally we recommend to use points of service (https://developer.allegro.pl/documentation/#tag/Points-of-service)

        name
        required
        string <= 75 characters

        Name (title) of an offer. Length cannot be more than 75 characters. Read more: PL / EN .

        Array of objects (Parameter) [ items ]
        object (Payments)
        object (JustId)
        object (Promotion)

        Promo options on base marketplace.

        object (Publication)
        object (SellingModeWithNetPrice)

        Information on the offer's selling mode.

        object (ExtendedTax)
        Deprecated

        VAT tax settings. Available settings can be found under "get all tax settings for category" resource. This field is deprecated in favor of taxSettings.

        object (OfferTaxSettings)

        Tax settings for offer. Available settings can be found under "get all tax settings for category" resource.

        object (JustId)
        object (Stock)
        object (TecdocSpecification)

        Contains additional information describing products from automotive categories. Technical specification is created based on TecDoc database and can only be used while creating offer with assigned product to it. Read more.

        object (B2b)

        Defines offer properties for buyers with company account (Allegro Biznes).

        object (MessageToSellerSettings)

        Defines message to the seller settings options.

        updatedAt
        string <date-time>

        Last update date: Format (ISO 8601) - yyyy-MM-dd'T'HH:mm:ss.SSSZ. Cannot be modified

        object (Validation)
        language
        string <BCP-47 language code>

        Declared base language of the offer.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "category": {
          },
        • "additionalMarketplaces": {
          },
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "compatibilityList": {
          },
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "customParameters": [
          ],
        • "delivery": {
          },
        • "description": {
          },
        • "discounts": {
          },
        • "external": {
          },
        • "fundraisingCampaign": {
          },
        • "id": "string",
        • "images": [
          ],
        • "location": {
          },
        • "name": "string",
        • "parameters": [
          ],
        • "payments": {
          },
        • "product": {
          },
        • "promotion": {
          },
        • "publication": {
          },
        • "sellingMode": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "category": {
          },
        • "additionalMarketplaces": {
          },
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "compatibilityList": {
          },
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "customParameters": [
          ],
        • "delivery": {
          },
        • "description": {
          },
        • "discounts": {
          },
        • "external": {
          },
        • "fundraisingCampaign": {
          },
        • "id": "string",
        • "images": [
          ],
        • "location": {
          },
        • "name": "string",
        • "parameters": [
          ],
        • "payments": {
          },
        • "product": {
          },
        • "promotion": {
          },
        • "publication": {
          },
        • "sellingMode": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Complete a draft offer or edit an offer Deprecated

        Complete a draft offer or edit ongoing offers. This endpoint is deprecated: PL / EN. Use PATCH /sale/product-offers/{offerId} instead. Read more: PL / EN. This resource is rate limited to 10 requests per second.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        Request Body schema: application/vnd.allegro.public.v1+json

        offer

        object

        Category in which the offer is listed for sale. You can indicate a category from the product's 'similar categories' to set the offer's category.

        object (AdditionalMarketplaces)

        Settings for each additional marketplace.

        object (JustId)
        object (AfterSalesServices)

        The definitions of the different after sales services assigned to the offer.

        Array of objects (Attachment) [ items ]

        List of offer attachments. You can attach up to 7 files to the offer – one per each attachment type as described in uploading offer attachments flow.

        object (CompatibilityList)
        object (JustId)
        createdAt
        string <date-time>

        Creation date: Format (ISO 8601) - yyyy-MM-dd'T'HH:mm:ss.SSSZ. Cannot be modified.

        Array of objects (CustomParameter) [ items ]

        List of custom parameters. You can add up to 4 custom parameters, each containing exactly one value.

        object (DeliveryFull)
        object (StandardizedDescription)

        The description section cannot have more than 40000 bytes in length.

        object (Discounts)
        object (ExternalId)

        The information on the offer in an external system.

        object (JustId)
        id
        string
        Array of objects (ImageUrl) [ items ]
        object (Location)

        for offer with a delivery method it is a parcel dispatch location. For offers with personal pick-up it is a pick-up location, additionally we recommend to use points of service (https://developer.allegro.pl/documentation/#tag/Points-of-service)

        name
        required
        string <= 75 characters

        Name (title) of an offer. Length cannot be more than 75 characters. Read more: PL / EN .

        Array of objects (Parameter) [ items ]
        object (Payments)
        object (JustId)
        object (Promotion)

        Promo options on base marketplace.

        object (Publication)
        object (SellingModeWithNetPrice)

        Information on the offer's selling mode.

        object (ExtendedTax)
        Deprecated

        VAT tax settings. Available settings can be found under "get all tax settings for category" resource. This field is deprecated in favor of taxSettings.

        object (OfferTaxSettings)

        Tax settings for offer. Available settings can be found under "get all tax settings for category" resource.

        object (JustId)
        object (Stock)
        object (TecdocSpecification)

        Contains additional information describing products from automotive categories. Technical specification is created based on TecDoc database and can only be used while creating offer with assigned product to it. Read more.

        object (B2b)

        Defines offer properties for buyers with company account (Allegro Biznes).

        object (MessageToSellerSettings)

        Defines message to the seller settings options.

        updatedAt
        string <date-time>

        Last update date: Format (ISO 8601) - yyyy-MM-dd'T'HH:mm:ss.SSSZ. Cannot be modified

        object (Validation)
        language
        string <BCP-47 language code>

        Declared base language of the offer.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "category": {
          },
        • "additionalMarketplaces": {
          },
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "compatibilityList": {
          },
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "customParameters": [
          ],
        • "delivery": {
          },
        • "description": {
          },
        • "discounts": {
          },
        • "external": {
          },
        • "fundraisingCampaign": {
          },
        • "id": "string",
        • "images": [
          ],
        • "location": {
          },
        • "name": "string",
        • "parameters": [
          ],
        • "payments": {
          },
        • "product": {
          },
        • "promotion": {
          },
        • "publication": {
          },
        • "sellingMode": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "category": {
          },
        • "additionalMarketplaces": {
          },
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "compatibilityList": {
          },
        • "contact": {
          },
        • "createdAt": "2019-08-24T14:15:22Z",
        • "customParameters": [
          ],
        • "delivery": {
          },
        • "description": {
          },
        • "discounts": {
          },
        • "external": {
          },
        • "fundraisingCampaign": {
          },
        • "id": "string",
        • "images": [
          ],
        • "location": {
          },
        • "name": "string",
        • "parameters": [
          ],
        • "payments": {
          },
        • "product": {
          },
        • "promotion": {
          },
        • "publication": {
          },
        • "sellingMode": {
          },
        • "tax": {
          },
        • "taxSettings": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Delete a draft offer

        Use this resource to delete a draft offer. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        Responses

        Modify the Buy Now price in an offer

        Use this resource to change the Buy Now price in a single offer. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        offerId
        required
        string

        The offer identifier.

        commandId
        required
        string <uuid>

        The unique command id generated by you.

        Request Body schema: application/vnd.allegro.public.v1+json
        id
        string <uuid>

        The unique command id generated by you. This should be the same UUID as used in the path.

        required
        object (ChangePriceInput)

        The input of the command, i.e. the new Buy Now price for the offer.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "6365996a-6cae-11e9-a923-1681be663d3e",
        • "input": {
          }
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "6365996a-6cae-11e9-a923-1681be663d3e",
        • "input": {
          },
        • "output": {
          }
        }

        Batch offer publish / unpublish

        Use this resource to modify multiple offers publication at once. Read more: PL / EN. This resource is rate limited to 250 000 offer changes per hour or 9000 offer changes per minute.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        commandId
        required
        string

        Command identifier.

        Request Body schema: application/vnd.allegro.public.v1+json

        publicationChangeCommandDto

        Array of objects (OfferCriterium) [ items ]

        List of offer criteria

        object (Publication_modification)

        Contains publication's fields to change

        Responses

        Request samples

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

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "createdAt": "2019-08-24T14:15:22Z",
        • "completedAt": "2019-08-24T14:15:22Z",
        • "taskCount": {
          }
        }

        Publish command summary

        Use this resource to retrieve information about the offer listing statuses. You will receive a summary with a number of correctly listed offers and errors. Read more: PL / EN. This resource is rate limited to retrieving information about 270 000 offer changes per minute.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        commandId
        required
        string

        Command identifier.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "createdAt": "2019-08-24T14:15:22Z",
        • "completedAt": "2019-08-24T14:15:22Z",
        • "taskCount": {
          }
        }

        Publish command detailed report

        Use this resource to retrieve information about the offer statuses on the site (Defaults: limit = 100, offset = 0). Read more: PL / EN. This resource is rate limited to retrieving information about 270 000 offer changes per minute.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        commandId
        required
        string

        Command identifier.

        query Parameters
        limit
        integer <int32> [ 1 .. 1000 ]
        Default: 100

        The limit of elements in the response.

        offset
        integer <int32> [ 0 .. 999 ]
        Default: 0

        The offset of elements in the response.

        Responses

        Response samples

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

        Get all available offer promotion packages

        Use this resource to retrieve all available offer promotion packages. Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "marketplaceId": "allegro-pl",
        • "basePackages": [
          ],
        • "extraPackages": [
          ],
        • "additionalMarketplaces": [
          ]
        }

        Modify offer promotion packages

        Use this resource to modify offer promotion packages. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        offerId
        required
        string
        Example: 9991337999

        Offer identifier.

        Request Body schema: application/vnd.allegro.public.v1+json

        request

        Array of objects (PromoOptionsModification) [ items ]

        Promo package modifications to be applied.

        Array of objects (AdditionalMarketplacePromoOptionsModification) [ items ]

        Promo package modifications to be applied on additional marketplaces.

        Responses

        Request samples

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

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offerId": "9991337999",
        • "marketplaceId": "allegro-pl",
        • "basePackage": {
          },
        • "extraPackages": [
          ],
        • "pendingChanges": {
          },
        • "additionalMarketplaces": [
          ]
        }

        Get offer promotion packages

        Use this resource to get promotion packages assigned to an offer. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string
        Example: 9991337999

        Offer identifier.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offerId": "9991337999",
        • "marketplaceId": "allegro-pl",
        • "basePackage": {
          },
        • "extraPackages": [
          ],
        • "pendingChanges": {
          },
        • "additionalMarketplaces": [
          ]
        }

        Get promo options for seller's offers

        Use this resource to retrieve promo options for seller offers. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        query Parameters
        limit
        integer <int32> [ 1 .. 5000 ]
        Default: 5000

        Limit of promo options per page.

        offset
        integer <int64> >= 0
        Default: 0

        Distance between the beginning of the document and the point from which promo options are returned.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "promoOptions": [
          ],
        • "count": 3,
        • "totalCount": 256
        }

        Batch offer promotion package modification

        Use this resource to modify promotion packages on multiple offers at once. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        commandId
        required
        string
        Example: aca8103b-14eb-4855-b9b3-de5bef06bd30

        Command identifier. Must be a UUID.

        Request Body schema: application/vnd.allegro.public.v1+json

        Promo packages modification command request.

        Array of objects (OfferCriterium) [ items ]

        Offer choice criteria.

        object (PromoOptionsCommandModification)
        Array of objects (AdditionalMarketplacePromoOptionsCommandModification) [ items ]

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offerCriteria": [
          ],
        • "modification": {
          },
        • "additionalMarketplaces": [
          ]
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "taskCount": {
          }
        }

        Modification command summary

        Use this resource to find out how many offers were edited within one {commandId}. You will receive a summary with a number of successfully edited offers and errors. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        commandId
        required
        string

        Command identifier.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "string",
        • "taskCount": {
          }
        }

        Modification command detailed result

        Use this resource to retrieve the result of an offer modification command. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        commandId
        required
        string

        Command identifier.

        query Parameters
        limit
        integer [ 1 .. 1000 ]
        Default: 100

        The limit of returned items.

        offset
        integer >= 0
        Default: 0

        The offset of returned items.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "tasks": [
          ],
        • "modification": {
          },
        • "additionalMarketplaces": [
          ]
        }

        Get offers with missing parameters

        Use this resource to get information about required parameters or parameters scheduled to become required that are not filled in offers. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        query Parameters
        offer.id
        Array of strings

        List of offer ids. If empty all offers with unfilled parameters will be returned.

        parameterType
        string
        Enum: "REQUIRED" "REQUIREMENT_PLANNED"

        Filter by parameter type.

        offset
        integer <int32> >= 0
        Default: 0

        The offset of elements in the response.

        limit
        integer <int32> [ 1 .. 1000 ]
        Default: 100

        The limit of elements in the response.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "offers": [
          ],
        • "count": 3,
        • "totalCount": 256
        }

        Offer translations

        Get offer translations

        Get offer translation for given language or all present. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        path Parameters
        offerId
        required
        string

        Offer identifier.

        query Parameters
        language
        string <BCP-47 language code>
        Example: language=en-US

        Language for translation to retrieve. If not provided, all translations as well as base content for offer will be returned.

        Responses

        Response samples

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

        Update offer translation

        Update manual translation for offer. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        language
        required
        string <BCP-47 language code>
        Example: en-US

        Language of the provided translation.

        offerId
        required
        string

        Offer identifier.

        Request Body schema: application/vnd.allegro.public.v1+json

        Request with manual translation for offer, must contain at least one translated offer element (title or description).

        object (ManualDescriptionTranslation)

        Manual offer description translation

        object (ManualTitleTranslation)

        Manual offer title translation

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "description": {
          },
        • "title": {
          }
        }

        Response samples

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

        Delete offer translation

        Delete single element or entire manual translation. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        language
        required
        string <BCP-47 language code>
        Example: en-US

        Language of the translation to delete.

        offerId
        required
        string

        Offer identifier.

        query Parameters
        element
        string
        Enum: "title" "description"

        Offer element for which translation should be deleted. If not provided, translations for all elements will be deleted.

        Responses

        Response samples

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

        Categories and parameters

        Get IDs of Allegro categories

        Use this resource to traverse the Allegro categories tree. It returns the list of the given category's children or a list of the main Allegro categories. Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user
        query Parameters
        parent.id
        string
        Default: "954b95b6-43cf-4104-8354-dea4d9b10ddf"

        The ID of the category which children should be returned. If omitted, the list of main Allegro categories will be returned.

        Responses

        Response samples

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

        Get a category by ID

        Use this resource to get the details of a specific category. Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user
        path Parameters
        categoryId
        required
        string
        Example: 6061

        The category ID.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "12",
        • "leaf": true,
        • "name": "Pozostałe",
        • "options": {
          },
        • "parent": {
          }
        }

        Get parameters supported by a category

        Use this resource to get the list of parameters that are supported by the given category. Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user
        path Parameters
        categoryId
        required
        string
        Example: 709

        The category ID.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        Example
        Integer
        Integer
        String single
        Dictionary
        Float
        Float range
        {
        • "parameters": [
          ]
        }

        Get planned changes in category parameters

        Use this resource to get information about planned changes in category parameters. Please note that in some cases, the returned events may finally not happen in the future. At present we support the following changes: - REQUIREMENT_CHANGE - the parameter will be required in the category. Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user
        query Parameters
        scheduledFor.gte
        string <date-time>
        Example: scheduledFor.gte=2020-11-13T12:45:20.818Z

        The minimum date and time from which the change will be effective from in ISO 8601 format. Should be greater than the current date time and less than 3 months from the current date.

        scheduledFor.lte
        string <date-time>
        Example: scheduledFor.lte=2020-11-13T12:45:20.818Z

        The maximum date and time from which the change will be effective from in ISO 8601 format. Should be greater than the current date time and less than 3 months from the current date.

        scheduledAt.gte
        string <date-time>
        Example: scheduledAt.gte=2020-11-13T12:45:20.818Z

        The minimum date and time at which the change was scheduled in ISO 8601 format.

        scheduledAt.lte
        string <date-time>
        Example: scheduledAt.lte=2020-11-13T12:45:20.818Z

        The maximum date and time at which the change was scheduled in ISO 8601 format.

        type
        Array of strings
        Items Value: "REQUIREMENT_CHANGE"

        The types of changes that will be returned in the response. All types of changes are returned by default.

        offset
        integer <int32> >= 0
        Default: 0

        The offset of elements in the response.

        limit
        integer <int32> [ 1 .. 1000 ]
        Default: 100

        The limit of elements in the response.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "scheduledAt": "2019-06-26T15:26:43.891Z",
        • "scheduledFor": "2019-07-26T15:26:43.891Z",
        • "type": "REQUIREMENT_CHANGE",
        • "category": {
          },
        • "parameter": {
          }
        }

        Get changes in categories

        Use this resource to get information about changes in categories. It returns changes that occurred in the last 3 months. At present we support the following changes:

        • CATEGORY_CREATED - new category was created.
        • CATEGORY_RENAMED - category name has been changed.
        • CATEGORY_MOVED - category has been moved to a different place in category tree, category parent id field is changed.
        • CATEGORY_DELETED - category is no longer available, category from redirectCategory field should be used instead.

        Read more: PL / EN.

        Authorizations:
        bearer-token-for-applicationbearer-token-for-user
        query Parameters
        from
        string <= 256 characters
        Example: from=MTEzMjQzODU3NA

        The ID of the last seen event. Changes that occurred after the given event will be returned.

        limit
        integer [ 1 .. 1000 ]
        Default: 100

        The number of events that will be returned in the response.

        type
        Array of strings
        Items Enum: "CATEGORY_CREATED" "CATEGORY_RENAMED" "CATEGORY_MOVED" "CATEGORY_DELETED"

        The types of events that will be returned in the response. All types of events are returned by default.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        Example
        Category created event
        Category created event
        Category renamed event
        Category moved event
        Category deleted event
        {
        • "id": "MTEzMjQzODU3NA",
        • "occurredAt": "2019-06-26T15:26:43.891Z",
        • "type": "CATEGORY_CREATED",
        • "category": {
          }
        }

        Get categories suggestions

        Use this resource to receive suggested categories for given phrase. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user
        query Parameters
        name
        required
        string
        Example: name=bmw x3

        Product name for which you want to get suggested categories.

        Responses

        Response samples

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

        Images and attachments

        Upload an offer image

        Upload image to our servers. You can choose from two upload options:

        • - provide a link and we will download an image for you
        • - send an image as binary data

        Important! Remember to use dedicated domain for upload, i.e.

        Read more: PL / EN. More information about rules for photos in an offer's gallery and description you will find here.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        Request Body schema:
        application/vnd.allegro.public.v1+json
        application/vnd.allegro.public.v1+json
        image/jpeg
        image/png
        image/webp
        url
        required
        string

        URL of the image. It has to contain domain name, not an IP address. Currently we support http and https protocols. When using https the certificate chain needs to be valid.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        application/vnd.allegro.public.v1+json
        image/jpeg
        image/png
        image/webp
        {
        • "url": "string"
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "expiresAt": "2019-08-24T14:15:22Z",
        • "location": "string"
        }

        Create an offer attachment

        You can attach pdf, jpeg or png files to your offers. We will present them under the offer description in the Additional information section. You can attach up to 9 files to one offer – one per each type from the list:

        • Guide (MANUAL). Allowed media types: PDF
        • Special offer terms (SPECIAL_OFFER_RULES). Allowed media types: PDF
        • Competition terms (COMPETITION_RULES). Allowed media types: PDF
        • Book excerpt (BOOK_EXCERPT). Allowed media types: PDF
        • Manual (USER_MANUAL). Allowed media types: PDF
        • Installation manual (INSTALLATION_INSTRUCTIONS). Allowed media types: PDF
        • Game manual (GAME_INSTRUCTIONS). Allowed media types: PDF
        • Energy label (ENERGY_LABEL). Allowed media types: J