Changelog
How we develop the Allegro REST API.
27SEP
20211SEP
2021
New
POST /sale/size-tables - create a size table
PUT /sale/size-tables/{tableId} - edit the size table
GET /sale/size-tables-templates - get a list of table templates
24AUG
2021
New
PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId} - command change of the price or end of the offer designation in the campaign
GET /sale/badge-operations/{operationId} - check status of the price change or end of the offer designation in the campaign
19AUG
202118AUG
2021
18AUG
2021
2AUG
2021
New
GET /order/customer-returns - retrieve a list of customer returns
GET /order/customer-returns/{customerReturnId} - retrieve detailed information about customer return
POST /order/customer-returns/{customerReturnId}/rejection - reject customer return refund
26JUL
202121JUL
202120JUL
2021
19JUL
2021
New
GET /messaging/threads - retrieve the list of user threads,
GET /messaging/threads/{threadId} - retrieve a thread with provided identifier,
PUT /messaging/threads/{threadId}/read - mark a particular thread as read,
POST /messaging/messages - write a new message to recipient,
GET /messaging/threads/{threadId}/messages - retrieve a list of messages in thread with provided identifier,
POST /messaging/threads/{threadId}/messages - write a new message in existing thread,
GET /messaging/messages/{messageId} - retrieve a message with provided identifier,
DELETE /messaging/messages/{messageId} - delete message with provided identifier,
POST /messaging/message-attachments - add attachment declaration before uploading,
PUT /messaging/message-attachments/{attachmentId} - upload attachment using identifier that was declared,
GET /messaging/message-attachments/{attachmentId} - download attachment with provided identifier.
15JUL
202113JUL
20218JUL
2021
7JUL
20211JUL
2021
Update
29JUN
2021
14JUN
20217JUN
2021
New
GET /sale/allegro-prices-offer-consents/{offerId} - retrieve current offer consent information
PUT /sale/allegro-prices-offer-consents/{offerId} - update current offer consent information
GET /sale/allegro-prices-account-eligibility - retrieve current account eligibility information
PUT /sale/allegro-prices-account-consent - update account consent information
1JUN
202131MAY
2021
27MAY
202124MAY
202119MAY
2021
New
GET /sale/tax-settings?category.id={categoryId} - get all VAT settings available in the given category12MAY
202111MAY
2021
New
GET /order/carriers/ALLEGRO/points - retrieve list of Allegro pickup drop off points
GET /order/carriers/ALLEGRO/tracking - retrieve the history of Allegro parcels statuses
29APR
2021
8APR
202131MAR
2021
29MAR
2021
17MAR
20212MAR
20211MAR
2021
22FEB
202118FEB
2021
9FEB
2021
New
GET /order/checkout-forms/{id}/invoices - retrieve invoices assigned to the order
POST /order/checkout-forms/{id}/invoices - create invoice object
PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file - upload a *.pdf file with invoice
26JAN
2021
20JAN
202114JAN
2021
13JAN
2021
New
GET /sale/category-events - check changes in categorie
GET /sale/category-parameters-scheduled-changes - check planned changes in parameters
4JAN
202120NOV
2020
New
GET /sale/offers/unfilled-parameters - check offers unfilled parameters
GET /sale/categories/parameters/required-changes - check which parameters will be marked as required
17NOV
2020
New
GET /sale/offer-promotion-packages - retrieve available promo options
POST /sale/offers/{offerId}/promo-options-modification - assign promo options to an offer
GET /sale/offers/{offerId}/promo-options - check promo options assigned to an offer
PUT /sale/offers/promo-options-commands/{commandId} - assign promo options to multiple offers
GET /sale/offers/promo-options-commands/{commandId} - retrieve result of the task of assigning promo options
GET /sale/offers/promo-options-commands/{commandId}/tasks - retrieve detailed report for the task of assigning promo options
13NOV
202012NOV
2020
2NOV
202023OCT
2020
19OCT
2020
15OCT
2020
9OCT
20208OCT
2020
2OCT
2020
16SEP
2020
15SEP
2020
10SEP
2020
New
PUT /sale/loyalty/promotions/{promotionId} - change wholesale price list settings
10SEP
2020
Update
1SEP
2020
New
GET /parcel-management/delivery-services - retrieve a list of delivery services
PUT /parcel-management/parcel-create-commands/{commandId} - create a new parcel
GET parcel-management/parcel-create-commands/{commandId} - check parcel creation status
GET /parcel-management/parcels/{parcelId} - retrieve parcel details
PUT /parcel-management/cancel-commands/{commandId} - cancel a parcel
GET /parcel-management/cancel-commands/{commandId} - check parcel cancellation status
GET /parcel-management/pickup-date-proposals - check pickup date proposals
PUT /parcel-management/parcel-pickup-request-commands/{commandId} - request parcel pickup by a courier
GET /parcel-management/parcel-pickup-request-commands/{commandId} - check parcel pickup request status
GET /parcel-management/parcels/label - create a label for parcel
GET /parcel-management/parcels/protocol - retrieve parcel protocol
28AUG
2020
27AUG
20206AUG
2020
Update
New features in resources:
15JUL
202014JUL
2020
26JUN
2020
10JUN
20209JUN
20204JUN
2020
3JUN
2020
27MAY
202020MAY
2020
Delete
deleted resource: GET /payments/payment-id-mappings
18MAY
202015MAY
2020
14MAY
20207MAY
2020
5MAY
202024APR
2020
7APR
2020
New
6APR
20202APR
2020
24MAR
2020
New
POST /order/refund-claims - create a sale commission refund application
GET /order/refund-claims - retrieve list of sale commission refunds applications
GET /order/refund-claims/{claimId} - retrieve a sale commission refund application details
DELETE /order/refund-claims/{claimId} - cancel a sale commission refund application
18MAR
2020
17MAR
20209MAR
20206FEB
2020
Update
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{id}
27JAN
2020
New
new resource: PUT /order/checkout-forms/{checkoutForm.id}/fulfillment
16JAN
2020
Update
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{id}
13JAN
2020
New
new resource: PUT /sale/user-ratings/{ratingId}/answer
new resource: PUT /sale/user-ratings/{ratingId}/removal
9DEC
2019
Update
new feature in resource: POST/order/checkout-forms/{id}/shipments
5DEC
2019
Update
changes in resource: POST /sale/offers
29NOV
2019
Update
new feature in resource: GET /sale/offers
27NOV
2019
Update
new feature in resource: GET /order/checkout-forms
21NOV
2019
Update
new feature in resource: GET /sale/offer-events
19NOV
2019
Update
new feature in resource: POST /sale/badges
new feature in resource: GET /sale/badge-applications/{applicationId}}
new feature in resource: GET /sale/badge-applications
13NOV
2019
Update
new feature in resource: GET /sale/products
new feature in resource: GET /sale/products/{productId}
21OCT
2019
New
new resource: GET /billing/billing-entries
9OCT
2019
Update
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{id}
2OCT
2019
Update
changes in resource: GET /users/{userId}/ratings-summary
changes in resource: GET /sale/user-ratings
26SEP
2019
New
new resource: GET /me
19SEP
2019
Update
new feature in resource: GET /sale/products/{product.id}
new feature in resource: POST /sale/offers
new feature in resource: PUT /sale/offers
new feature in resource: GET /sale/offers
12SEP
2019
2SEP
2019
Update
new feature in resource: GET /sale/offer-events
14AUG
2019
Update
new feature in resource: GET /sale/offers
13AUG
2019
Update
new feature in resource: GET /order/checkout-forms/{checkoutForm_id}
new feature in resource: GET /order/checkout-forms
12AUG
2019
Update
new feature in resource: PUT /sale/offer-modification-commands/{commandId}
9AUG
2019
Update
changing version on public: PUT /bidding/offers/{offerId}/bid
changing version on public: GET /bidding/offers/{offerId}/bid
2AUG
2019
Update
new feature in resource: GET /order/checkout-forms/{checkoutForm_id}
new feature in resource: GET /order/checkout-forms
1AUG
2019
31JUL
2019
New
new resource: GET /sale/badge-campaigns
new resource: POST /sale/badges
new resource: GET /sale/badge-applications/{applicationId}
new resource: GET /sale/badge-applications
new resource: GET /sale/badges?offer.id={offerId}
30JUL
2019
New
new resource: POST /sale/product-proposals
Delete
deleted resource: POST /sale/products
24JUL
2019
New
new resource: GET /sale/offer-events
12JUL
2019
New
new resource: GET /sale/compatibility-list/supported-categories
11JUL
2019
New
new resource: GET /sale/categories/{categoryId}/product-parameters
new resource: POST /sale/products
9JUL
2019
New
new feature in resource: GET /sale/loyalty/promotions
9JUL
2019
New
new resource: GET /sale/blacklisted-users
new resource: POST /sale/blacklisted-users
new resource: DELETE /sale/blacklisted-users/{excludedUserId}
2JUL
2019
1JUL
2019
Update
new feature in resource: GET /sale/delivery-methods
28JUN
2019
New
new resource: GET /sale/compatible-products/groups
new resource: GET /sale/compatible-products
new resource: GET /payments/payment-id-mappings
27JUN
2019
Update
new feature in resource: POST /sale/offers
new feature in resource: PUT /sale/offers/{offerId}
new feature in resource: GET /sale/offers/{offerId}
12JUN
2019
New
new resource: GET /sale/offers/{offerId}/shipping-rates
24APR
2019
New
new resource: POST /account/additional-emails
new resource: GET /account/additional-emails
new resource: GET /account/additional-emails/{emailId}
new resource: DELETE /account/additional-emails/{emailId}
20MAR
2019
27FEB
2019
New
new resource: GET /order/checkout-forms/{checkoutForm.id}/shipments
19FEB
2019
New
new resource: POST /order/checkout-forms/{checkoutForm.id}/shipments
14FEB
2019
Update
new feature in resource: GET /sale/offers/
14FEB
2019
Update
changes in resource: POST /sale/offer-contacts
24JAN
2019
Update
new feature in resource: POST /sale/images (upload.allegro.pl)
26NOV
2018
Update
new feature in resource: GET /order/events
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{checkoutForm_id}
22NOV
2018
NEW
new resource: PUT /sale/offer-price-change-commands/{commandId}
new resource: GET /sale/offer-price-change-commands/{commandId}
new resource: GET /sale/offer-price-change-commands/{commandId}/tasks
new resource: PUT /sale/offer-quantity-change-commands/{commandId}
new resource: GET /sale/offer-quantity-change-commands/{commandId}
05NOV
2018
NEW
new resource: POST /sale/loyalty/promotion-campaigns
new resource: GET /sale/loyalty/promotion-campaigns
30OCT
2018
Update
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{id}
25OCT
2018
Update
new feature in resource: GET /order/checkout-forms
new feature in resource: GET /order/checkout-forms/{id}
22OCT
2018
NEW
changes in resource: GET /sale/categories/{categoryId}/parameters
18OCT
2018
NEW
new resource: GET /sale/offers
15OCT
2018
Update
new feature in resource: GET /sale/delivery-methods
12OCT
2018
Update
changes in resource: PUT /sale/offer-publication-commands/{commandId}
changes in resource: PUT /sale/offer-modification-commands/{commandId}
09OCT
2018
NEW
new resource: GET /order/line-item-id-mappings
09OCT
2018
NEW
new resource: DELETE /sale/offers/{offerId}
08OCT
2018
Update
new feature in resource: Promotions/Promotions (GET)
new feature in resource: Promotions/Promotions (POST)
new feature in resource: Promotions/Promotions {id} (DELETE)
new feature in resource: Promotions/Promotions {id} (GET)
04OCT
2018
Update
new feature in resource: Offers/Listing (GET)
03OCT
2018
Update
new feature in resource: Pricing/Fee preview (POST)
26SEP
2018
Update
changing version on public: GET /sale/offer-tags?user.id={user_ID}
changing version on public: POST /sale/offers
changing version on public: PUT /sale/offers/{offerId}
changing version on public: GET /sale/offers/{offerId}
changing version on public: PUT /sale/offer-publication-commands/{commandId}
changing version on public: GET /sale/offer-publication-commands/{commandId}
changing version on public: GET /sale/offer-publication-commands/{commandId}/tasks
changing version on public: GET /sale/categories
changing version on public: GET /sale/categories/{categoryId}
changing version on public: GET /sale/categories/{categoryId}/parameters
changing version on public: GET /sale/shipping-rates
changing version on public: GET /sale/shipping-rates/{id}
changing version on public: GET /sale/delivery-methods
changing version on public: GET /sale/size-tables/{tableId}
changing version on public: GET /sale/size-tables
changing version on public: POST /sale/images (upload.allegro.pl)
25SEP
2018
NEW
new resource: GET /sale/offer-tags?user.id={user_ID}
new resource: POST /sale/offer-tags
new resource: DELETE /sale/offer-tags/{tag_ID}
new resource: PUT /sale/offer-tags/{tag_ID}
new resource: GET /sale/offers/{offer_ID}/tags
new resource: POST /sale/offers/{offer_ID}/tags
new resource: POST /sale/offer-attachments
18SEP
2018
NEW
new resource: GET /sale/disputes
new resource: GET /sale/disputes?checkoutForm.id={checkoutForm.id}
new resource: GET /sale/disputes/{dispute.Id}
new resource: GET/sale/disputes/{dispute.Id}/message
new resource: GET /sale/dispute-attachments/{attachment.Id}
new resource: POST /sale/disputes/{dispute.id}/messages
new resource: POST /sale/dispute-attachments/
new resource: PUT https://upload.allegro.pl/dispute-attachments/{attachment.Id}
16AUG
2018
NEW
new resource: Order/event-stats (GET)
14AUG
2018
NEW
new resource: Sale/shipping-rates (POST)
new resource: Sale/shipping-rates/{shippingRatesId} (PUT)
7AUG
2018
NEW
new resource: Order/events (GET)
new resource: Order/checkout-forms/{id} (GET)
new resource: Order/checkout-forms (GET)
27JUL
2018
NEW
new resource: Sale/offer-variants (GET)
9JUL
2018
NEW
new resource: Sale/offer-variants/{setId} (DELETE)
new resource: Sale/offer-variants/{setId} (GET)
new resource: Sale/offer-variants/{setId} (PUT)
3JUL
2018
NEW
new resource: Offers/Listing (GET)
11MAY
2018
Update
new feature in resource: Pricing/Fee preview (POST)
19APR
2018
12APR
2018
NEW
new resource: Sale/offer-publication-commands/{commandId} (GET)
new resource: Sale/offer-publication-commands/{commandId} (PUT)
new resource: Sale/offers (POST)
new resource: Sale/delivery-methods (GET)
new resource: Sale/offers/{offerId} (GET)
new resource: Sale/offers/{offerId} (PUT)
new resource: Sale/offer-publication-commands/{commandId}/tasks (GET)
new resource: Sale/categories/{categoryId}/parameters (GET)
new resource: Sale/categories (GET)
new resource: Sale/categories/{categoryId} (GET)
new resource: Sale/shipping-rates (GET)
new resource: Sale/shipping-rates/{id} (GET)
14FEB
2018
NEW
new resource: Pricing/offer-quotes (GET)
1FEB
2018
NEW
new feature in resource: Promotions/Promotions (GET)
new feature in resource: Promotions/Promotions (POST)
new feature in resource: Promotions/Promotions {id} (DELETE)
new feature in resource: Promotions/Promotions {id} (GET)
17JAN
2018
NEW
new resource: Offer contacts (POST)
new resource: Offer contacts (PUT)
new resource: Offer contacts (GET)
new resource: Offer contacts (GET)
9NOV
2017
NEW
new resource: Offer modification commands {commandId} (PUT)
new resource: Offer modification commands {commandId} (GET)
new resource: Offer modification commands {commandId}/tasks (GET)
2NOV
2017
NEW
new resource: Offer additional services {user.id} (GET)
new resource: Offer additional services (POST)
new resource: Offer additional services (GET)
new resource: Offer additional services {groupId} (GET)
new resource: Offer additional services {groupId} (PUT)
30OCT
2017
Update
new resource: Pricing/Fee preview (POST)
18OCT
2017
NEW
new resource: Promotions/Promotions (GET)
new resource: Promotions/Promotions (POST)
new resource: Promotions/Promotions {id} (DELETE)
new resource: Promotions/Promotions {id} (GET)
9OCT
2017
9OCT
2017
DELETE
removal of resources from documentation: Seller ratings (GET)
removal of resources from documentation: Seller summary (GET)
19SEP
2017
NEW
new resource: Pricing/Fee preview (POST)
14AUG
2017
NEW
new resource: Point of service (GET)
new resource: Point of service (POST)
new resource: Point of service {id} (DELETE)
new resource: Point of service {id} (GET)
new resource: Point of service {id} (PUT)
22JUN
2017
06APR
2017
DELETE
removal of resources: Change Additional Platforms Commands (PUT)
removal of resources: Change Additional Platforms Commands (GET)
05APR
2017
NEW
new resource: Get Seller Implied Warranties Listing (GET)
new resource: Get Seller Return Policies Listing (GET)
new resource: Get Seller Warranties Listing (GET)
01FEB
2017
NEW
new resource: Change Additional Platforms Commands (PUT)
new resource: Change Additional Platforms Commands (GET)
11AUG
2016
BUGFIX
fix - authorization procces: refresh_token allows you to extend the validity of user authentication for applications up to max. 365 days
01AUG
2016
NEW
new resource: Change the Buy Now price