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 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.

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

        The upper threshold of price.

        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.

        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

        Allow 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.

        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

        Allow to filter offers by existence of product ID.

        productizationRequired
        boolean

        Allow to filter offers from categories where productization is required.

        b2b.buyableOnlyByBusiness
        boolean

        Allow to filter business offers.

        Responses

        Response samples

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

        Get all fields of the particular offer

        Use this resource to retrieve all fields of the particular 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
        {
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "category": {
          },
        • "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": {
          },
        • "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.

        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

        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"

        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
        {
        • "id": "MTEzMjQzODU3NA",
        • "occurredAt": "2019-06-26T15:26:43.891Z",
        • "type": "OFFER_ACTIVATED",
        • "offer": {
          }
        }

        Offer management

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

        Create a draft offer

        Use this resource to create a draft offer. 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 (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

        Category in which the offer is listed for sale

        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 <= 50 characters

        Name of the offer. Words used in the name field cannot be longer than 50 characters.

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

        Information on the offer's selling mode.

        object (ExtendedTax)

        VAT tax settings. 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
        {
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "category": {
          },
        • "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": {
          },
        • "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
        {
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "category": {
          },
        • "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": {
          },
        • "sizeTable": {
          },
        • "stock": {
          },
        • "tecdocSpecification": {
          },
        • "b2b": {
          },
        • "messageToSellerSettings": {
          },
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "validation": {
          },
        • "language": "pl-PL"
        }

        Complete a draft offer or edit an offer

        Use this resource to complete a draft offer or edit ongoing offers. 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 (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

        Category in which the offer is listed for sale

        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 <= 50 characters

        Name of the offer. Words used in the name field cannot be longer than 50 characters.

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

        Information on the offer's selling mode.

        object (ExtendedTax)

        VAT tax settings. 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
        {
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "category": {
          },
        • "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": {
          },
        • "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
        {
        • "additionalServices": {
          },
        • "afterSalesServices": {
          },
        • "attachments": [
          ],
        • "category": {
          },
        • "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": {
          },
        • "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

        Batch offer publish / unpublish

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

        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",
        • "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.

        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",
        • "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.

        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
        {
        • "basePackages": [
          ],
        • "extraPackages": [
          ]
        }

        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.

        Responses

        Request samples

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

        Response samples

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

        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",
        • "basePackage": {
          },
        • "extraPackages": [
          ],
        • "pendingChanges": {
          }
        }

        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)

        Responses

        Request samples

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

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

        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.

        object
        object
        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

        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 should enter the size tabe identifier or name.

        object (DiscountsProductOfferRequest)
        name
        string <= 50 characters

        Name of the offer. Words used in the name field cannot be longer than 50 characters.

        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.

        required
        object (Stock)
        object (ExtendedTax)

        VAT tax settings. 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": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "category": {
          },
        • "parameters": [
          ],
        • "afterSalesServices": {
          },
        • "sizeTable": {
          },
        • "discounts": {
          },
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "stock": {
          },
        • "tax": {
          },
        • "messageToSellerSettings": {
          }
        }

        Response samples

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

        Declared base language of the offer.

        object

        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 should enter the size tabe identifier or name.

        object (DiscountsProductOfferRequest)
        name
        string <= 50 characters

        Name of the offer. Words used in the name field cannot be longer than 50 characters.

        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 (Stock)
        object (ExtendedTax)

        VAT tax settings. 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": {
          },
        • "publication": {
          },
        • "language": "pl-PL",
        • "category": {
          },
        • "parameters": [
          ],
        • "afterSalesServices": {
          },
        • "sizeTable": {
          },
        • "discounts": {
          },
        • "name": "string",
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "stock": {
          },
        • "tax": {
          },
        • "messageToSellerSettings": {
          }
        }

        Response samples

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

        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
        {
        • "productSet": [
          ],
        • "attachments": [
          ],
        • "fundraisingCampaign": {
          },
        • "additionalServices": {
          },
        • "delivery": {
          },
        • "publication": {
          },
        • "b2b": {
          },
        • "compatibilityList": {
          },
        • "language": "pl-PL",
        • "id": "string",
        • "validation": {
          },
        • "afterSalesServices": {
          },
        • "discounts": {
          },
        • "parameters": [
          ],
        • "createdAt": "2019-08-24T14:15:22Z",
        • "updatedAt": "2019-08-24T14:15:22Z",
        • "name": "string",
        • "category": {
          },
        • "payments": {
          },
        • "sellingMode": {
          },
        • "location": {
          },
        • "images": [
          ],
        • "description": {
          },
        • "external": {
          },
        • "stock": {
          },
        • "sizeTable": {
          },
        • "tax": {
          },
        • "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": {
          }
        }

        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)
        • Special offer terms (SPECIAL_OFFER_RULES)
        • Competition terms (COMPETITION_RULES)
        • Book excerpt (BOOK_EXCERPT)
        • Manual (USER_MANUAL)
        • Installation manual (INSTALLATION_INSTRUCTIONS)
        • Game manual (GAME_INSTRUCTIONS)
        • Energy label (ENERGY_LABEL)
        • Product information sheet (PRODUCT_INFORMATION_SHEET)

        Uploading attachments flow:

        1. Create an attachment object to receive an upload URL (POST /sale/offer-attachments),
        2. Use the upload URL to submit the file (PUT /sale/offer-attachments/{attachmentId}),
        3. Add attachments to the offer (PUT /sale/offers/{offerId}).

        Read more: PL / EN.

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

        offer attachment

        type
        string (AttachmentType)
        Enum: "MANUAL" "SPECIAL_OFFER_RULES" "COMPETITION_RULES" "BOOK_EXCERPT" "USER_MANUAL" "INSTALLATION_INSTRUCTIONS" "GAME_INSTRUCTIONS" "ENERGY_LABEL" "PRODUCT_INFORMATION_SHEET"

        offer attachment type

        object (AttachmentFileRequest)

        Responses

        Request samples

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

        Response samples

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

        Upload an offer attachment

        Upload an offer attachment. This operation should be used after creating an offer attachment with POST /sale/offer-attachments Important! You can find the URL address to upload the file to our server in the Location response header of POST /sale/offer-attachments. The URL is unique and one-time. As its format may change in time, you should always use the address from the header. Do not compose the address on your own. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        path Parameters
        attachmentId
        required
        string <uuid>

        The ID of the attachment.

        Request Body schema:
        application/pdf
        application/pdf
        image/jpeg
        image/png
        string <binary>

        File in a binary format

        Responses

        Products

        Get product parameters available in given category

        Use this resource to get the list of product parameters available in given category. You can use these parameters to create a new product. 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 search products results

        Use this resource to get a list of products according to provided parameters. At least ean or phrase parameter is required. Read more: PL / EN. This resource is limited with Leaky Bucket mechanism.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:read)
        query Parameters
        ean
        string <= 18 characters
        Deprecated

        The EAN values can include EAN, ISBN, and UPC identifier types. Parameter is depracated and will be removed in the future. Please use combination of phrase and mode (GTIN) parameters instead.

        phrase
        string <= 1024 characters

        Search phrase.

        mode
        string
        Enum: "GTIN" "MPN"

        Search mode. If not specified, we are searching by GTIN, MPN, product's name, parameters, etc.

        • GTIN - restricts the search filtering to GTINs (Global Trade Item Number), e.g. EAN, ISBN, UPC.
        • MPN - restricts the search filtering to MPNs (Manufacturer Part Number).
        category.id
        string

        The category identifier to filter results. This can only be used when searching by phrase.

        object

        You can filter and customize your search results to find exactly what you need by applying filters ids and their dictionary values to query according to the flowing pattern: id=value. When the filter definition looks like:

        {
  "id": "127448",
  "name": "Kolor",
  "type": "SINGLE",
  "values": [
    {
      "name": "biały",
      "value": "2"
    },
    {
      "name": "czarny",
      "value": "1" }
  ]
}

        You can use 'Kolor' filter to query results, i.e.:

        • 127448=2 for "biały"
        • 127448=1 for "czarny".
        page.id
        string

        A "cursor" to the next set of results.

        searchFeatures
        string
        Value: "SIMILAR_CATEGORIES"

        Enables additional search options: - SIMILAR_CATEGORIES - searching in the indicated category (category.id) and in 'similar categories' (works only if category.id is a leaf category).

        includeDrafts
        boolean

        Include products in draft state.

        Responses

        Response samples

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

        Get all data of the particular product

        Use this resource to retrieve all data of the particular product. Read more: PL / EN. This resource is limited with Leaky Bucket mechanism.

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

        The product identifier.

        query Parameters
        category.id
        string

        The similar category identifier. You can choose a category from 'similar categories' to filter the list of parameters available in the category context.

        includeDrafts
        boolean

        Return also if product is in draft state.

        Responses

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "c9e39cae-9cb6-11e9-a2a3-2a2ae2dbcce4",
        • "name": "iPhone 5s",
        • "category": {
          },
        • "images": [
          ],
        • "parameters": [
          ],
        • "offerRequirements": {
          },
        • "compatibilityList": {
          },
        • "tecdocSpecification": {
          },
        • "description": {
          },
        • "isDraft": true
        }

        Propose a product

        Use this resource to propose a product. Read more: PL / EN.

        Authorizations:
        bearer-token-for-user (allegro:api:sale:offers:write)
        Request Body schema: application/vnd.allegro.public.v1+json
        name
        required
        string <= 50 characters

        Suggested product name.

        required
        object (Category)

        Category in which the offer is listed for sale

        required
        Array of objects (ImageUrl) [ items ]

        List of product images. At least one image is required.

        required
        Array of objects (ProductParameter) [ items ]

        List of product parameters.

        object (StandardizedDescription)

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

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "name": "iPhone 5s",
        • "category": {
          },
        • "images": [
          ],
        • "parameters": [
          ],
        • "description": {
          }
        }

        Response samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "id": "c9e39cae-9cb6-11e9-a2a3-2a2ae2dbcce4",
        • "name": "iPhone 5s",
        • "category": {
          },
        • "images": [
          ],
        • "parameters": [
          ],
        • "offerRequirements": {
          },
        • "compatibilityList": {
          },
        • "tecdocSpecification": {
          },
        • "description": {
          },
        • "isDraft": true
        }

        Propose changes in product

        Use this resource to propose changes in product. Read more: PL / EN.

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

        The product identifier.

        Request Body schema: application/vnd.allegro.public.v1+json
        name
        required
        string <= 150 characters

        Proposed product name.

        note
        string <= 500 characters

        Note about product changes proposal.

        required
        object (Category)

        Category in which the offer is listed for sale

        required
        Array of objects (ImageUrl) [ items ]

        List of product images. At least one image is required.

        required
        Array of objects (ProductParameter) [ items ]

        List of product parameters.

        notifyViaEmailAfterVerification
        boolean

        Receive an email notification after product changes proposal resolution.

        Responses

        Request samples

        Content type
        application/vnd.allegro.public.v1+json
        {
        • "name": "iPhone 5s",
        • "note": "Some additional note to product changes proposal.",
        • "category": {
          },
        • "images": [
          ],
        • "parameters": [
          ],
        • "notifyViaEmailAfterVerification": true
        }

        Response samples