Get Shipment Packages (getShipmentPackages)
The following changes are planned for the
getShipmentPackagesendpoint:The maximum accessible record count will be limited to 10,000 (maxQueryWindowResult) (this limit may be reduced further in the future) The accessible data scope will be limited to the last 1 month Rate limit values will be updated, and 429 (Too Many Requests) errors may occur more frequently under high-volume requests
These changes will limit the use of the current endpoint for large dataset scanning scenarios.
- The 10,000 limit is based on the shipment package ID.
- The counter does not work based on orderNumber.
- It works based on the shipmentPackageId. If the same order is divided into multiple packages, each package is counted separately.How is the Limit Applied?
A maximum of size=200 packages are returned in a single request. The 10,000 limit is not the single response size, but the maximum record window accessible via pagination.Pagination is zero-based:
page=0&size=200: 1–200
page=1&size=200: 201–400
page=49&size=200: 9,801–10,000
Therefore, the safe access range is between page=0 and page=49.
How to determine if the filter result is more than 10,000?
The totalElements in the response indicates the total number of packages matching the filter.Example:
JSON {
talElements": 12540,
talPages": 63,
ge": 0,
ze": 200,
ntent": []This response means:
There are 12,540 packages matching the filter.
The current response contains only the first 200 packages.
Up to the first 10,000 records can be accessed via v2/orders.
The remaining 2,540 records cannot be retrieved using the same broad filter.
The check should be done as follows:
totalElements > 10000
totalPages might appear to be greater than 50; however, this does not mean all pages are accessible via v2/orders.What to do if there are more than 10,000 results?
1. The Stream Order Packages service can be used:
If all packages need to be retrieved, the stream service (Get Shipment Packages with Stream) should be used. The nextCursor from each response is sent in the next request; this continues until hasMore=false.
2. The date range can be narrowed down:
The query can be divided into smaller time intervals using startDate and endDate.Example:
First query: August 1–2
Second query: August 3–4
Third query: August 5–6
The totalElements value of each segment must be checked separately.
4. The filter can be narrowed down:
Depending on the need, the following fields can be used:- status
- orderNumber
- barcode
- shipmentPackageIds
- storeFrontCode
- startDate / endDate🚀 Recommended Action
For large data retrieval and synchronization operations, it is recommended to switch to the getShipmentPackagesStream endpoint.
The Stream endpoint:
- Works with cursor-based pagination
- Is optimized for large datasets
- Provides more efficient usage in terms of rate limits💡 Note
The existing
getShipmentPackagesendpoint can still be used; however, it is not suitable for scenarios such as:- Large data scanning (full scan)
- Periodic synchronization (polling)
Get Order PackagesYou can retrieve information about every order placed by customers, which corresponds to the products you have submitted to the Trendyol system and is in payment control, using this method. After the payment control by the system, the orders are automatically packaged, and order packages are created.
Order Inquiry and Sorting:
- You can send a maximum of 1000 requests to this service within one minute.
- Requests to the service will result in a response sorted by PackageLastModifiedDate.
- Querying by package status is possible using a query such as suppliers/(supplierid)/orders?status=Created. The available statuses are: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, Repack, UnPacked, UnSupplied.
- When fetching order information, packaging and processes should be performed based on the barcode values sent with createProducts for the respective products.
- You can query orders for the last one month using this service.Fields, Data Types, and Character Lengths:
- Field lengths and data types within the body may change with the natural increase in the number of orders. It is recommended to configure your system accordingly.
- orderNumber is represents the main order number in the Trendyol system. The corresponding id at the same level represents the created Order Package.
- customerId is a unique value assigned to the Trendyol customer account.
- deliveryAddressType can return as "Shipment" or "CollectionPoint." If it is "CollectionPoint," it is an order for delivery to a collection point.
- orderDate transmitted in Timestamp (milliseconds) format as GMT +3. The createdDate information is transmitted in GMT format. Pay attention to this information when performing the conversion.
- fastDeliveryType used for fast delivery information can take values such as "TodayDelivery," "SameDayShipping," "FastDelivery."
- The barcode used for the cargoTrackingNumber value in the Trendyol Seller Panel is in CODE128 format.
- Within the scope of Trendyol Export Partnership, we added the 3pByTrendyol field as a new field to our order package withdrawal service. The field is a boolean field. When the field value is true;
- The micro field will be false.
- Trendyol's company information will be included in the invoiceAddress data and invoices will be issued according to the information here.
- "defectiveClaimListingInsight" is a section that identifies products returned due to defective/missing/incorrect reasons and informs the seller about the specific problem that product caused for the customer when a new order arrives. This allows the seller to proactively take precautions when preparing and shipping products to avoid similar situations in the next order, aiming to reduce the rate of returns due to seller-related defects.Order Status Informations
- Orders with the "Awaiting" status should only be used for inventory-related operations. No other actions should be performed on orders in this status. Currently, necessary data is provided in the service response for orders in this status. Please note that in the future, this data may not be available.When you deliver orders in this status, there might be order cancellation processes, and Trendyol explicitly states that they do not accept responsibility for such cases.
- For canceled orders, you can use the "status=Cancelled,UnSupplied" parameter.
- For split orders, you can use the "status=UnPacked" parameter.
- If one or more items in an order package are canceled, the order package is broken, and a new ID and shipping barcode are generated while keeping the orderNumber the same.Accessing Address Information:
- You can access the ID values of Turkiye, Azerbaijani and GULF region address fields (city, district, neighborhood) returned by the order package retrieval service from Address Information.
- In some cases, address fields in orders from the GULF Region may return empty. Especially if you have controls regarding district information, we kindly request you to remove it.
Country of Origin Information:
- For packages generated in micro export orders, it is necessary to add the country of origin information to the invoices. The country of origin information will be returned through the "productOrigin" data under the "lines" field.
Gold, Fertilizer, and High-Value Orders:
- For gold, fertilizer, or orders exceeding 5000₺, the TCKN number is transmitted in the "IdentityNumber" field.
Corporate Invoiced Orders:
- To determine whether an order is corporate, check the "commercial" value in the order data.
- If the "commercial" value returns as "true," it indicates that the order is a corporate order.
- If the "commercial" value returns as "false," it indicates that the order belongs to an individual customer.
- Corporate Invoice Information: If the order belongs to a corporate customer (commercial=true), you can retrieve the following information from the invoiceAddress field:
- "company": Name of the company
- "taxNumber": Tax number of the company
- "taxOffice": Tax office to which the company is affiliated
- E-Invoice Registration Check: To check if the corporate customer is registered for e-invoice, use the "eInvoiceAvailable" value in the invoiceAddress field.
- If the "eInvoiceAvailable" value is "true," the customer is registered for e-invoice.
- If the "eInvoiceAvailable" value is "false," the customer is not registered for e-invoice.
"createdBy" can get the values below:
- "order-creation" -> The package is created directly with the coming order
- "cancel" -> The package is created after partial cancellation
- "split" -> The package is created based on the package split
- "transfer" -> Orders that are directed to another seller by Trendyol because the seller who received the order does not have the product.
GET getShipmentPackagesIf you do not use any parameter in the endpoint below, it returns you maximum one week order instead of all orders. If you use startDate and endDate parameters, the maximum allowable range is two weeks.
Order V2 ServicesThe following v2 endpoint service will be mandatory as of October 15, 2026. To continue your operations, you must use the updated endpoint service below. With this new V2 integration service:
The maximum accessible record (shipmentPackageId) count will be limited to 10,000 (maxQueryWindowResult)
WarningThe following endpoint services will be deprecated as of October 15, 2026. You must migrate to Order V2 endpoint services by this date.
Recommended Endpoint
Service Parameters
Parameter Parameter Value Explanation Type startDate It fetches the next orders from a specific date. Must be sent as Timestamp long endDate It fetches orders up to the specified date. Must be sent as Timestamp. long page Only return information on the specified page int size Specifies the maximum number to list on a page. int supplierId ID information of the relevant supplier should be sent long orderNumber Only a specific order number is given to bring that order's information string status Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, AtCollectionPoint, UnSupplied Fetchs the information according to the status of orders. string orderByField PackageLastModifiedDate Based on the last update date. string orderByField CreatedDate Based on the order creation date. string orderByDirection ASC Sorts from old to new. string orderByDirection DESC Sorts from new to old. string shipmentPackageIds Trendyol shipmentPackageIds long Sample Service Response
{ "totalElements": 1, "totalPages": 1, "page": 0, "size": 1, "content": [ { "shipmentAddress": { "id": 11111111, "firstName": "Trendyol", "lastName": "Customer", "company": "", "address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul", "address2": "", "city": "İstanbul", "cityCode": 34, "district": "Sarıyer", "districtId": 54, "countyId": 0, // for CEE region "countyName": "", // for CEE region "shortAddress": "", // for GULF region "stateName": "", // for GULF region "addressLines": { "addressLine1": "", "addressLine2": "" }, "postalCode": "34200", "countryCode": "TR", "neighborhoodId": 21111, "neighborhood": "Maslak Mahallesi", "phone": null, "fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul", "fullName": "Trendyol Customer" }, "orderNumber": "10654411111", "orderCountryCode": "TR", // the country where the customer is located, the country where the order was placed "packageGrossAmount": 498.90, "packageSellerDiscount": 0.00, "packageTyDiscount": 0.00, // If commercial is true, it may return full, if false, it will return 0. "packageTotalDiscount": 0.00, "discountDisplays": [ { "displayName": "Sepette %20 İndirim", "discountAmount": 100 } ], "taxNumber": null, "invoiceAddress": { "id": 11111112, "firstName": "Trendyol", "lastName": "Customer", "company": "", // Orders from the GULF region may be empty. "address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul", "address2": "", "city": "İstanbul", "cityCode": 0, "district": "Sarıyer", // Orders from the GULF region may be empty. "districtId": 54, "countyId": 0, // It will available for the CEE region. "countyName": "", // It will available for the CEE region. "shortAddress": "", // It will available for the GULF region. "stateName": "", // It will available for the GULF region. "addressLines": { "addressLine1": "", "addressLine2": "" }, "postalCode": "", // Orders from the GULF region may be empty. "sector": "", "countryCode": "TR", "neighborhoodId": 0, "phone": null, "latitude": "11.111111", "longitude": "22.222222", "fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul", "fullName": "Trendyol Customer", "taxOffice": "Company of OMS's Tax Office", // If it is not a corporate invoice (commercial=false), it will not be returned in the body. "taxNumber": "Company of OMS's Tax Number" // If it is not a corporate invoice (commercial=false), it will not be returned in the body. }, "customerFirstName": "Trendyol", "customerEmail": "[email protected]", "customerId": 1451111111, "supplierId": 2738, "customerLastName": "Customer", "channelId": 25, // if it is 1 then TR core order, if it is 25 then it is an order from luxury channel "shipmentPackageId": 3330111111, "cargoTrackingNumber": 7280027504111111, "cargoTrackingLink": "https://tracking.trendyol.com/?id=111111111-1111-1111-1111-11111111", "cargoSenderNumber": "210090111111", "sellerDeliveryMethod": "", // Returns null for Türkiye Marketplace "sellerOtpCode": "", // Returns null for Türkiye Marketplace "cargoProviderName": "Trendyol Express", "lines": [ { "quantity": 1, "salesCampaignId": 11, "productSize": "Tek Ebat", "stockCode": "111111", "productName": "Kuş ve Çiçek Desenli Tepsi - Yeşil / Altın Sarısı - 49 cm, 01SYM134, Tek Ebat", "contentId": 1239111111, "productOrigin": "TR", "sellerId": 2738, "lineGrossAmount": 498.90, "lineTotalDiscount": 0.00, "lineSellerDiscount": 0.00, "lineTyDiscount": 0.00, "discountDetails": [ { "lineItemPrice": 498.90, "lineItemSellerDiscount": 0.00, "lineItemTyDiscount": 0.00 } ], "currencyCode": "TRY", "productColor": "Yeşil", "lineId": 4765111111, "vatRate": 20.00, "barcode": "8683772071724", "orderLineItemStatusName": "Delivered", "lineUnitPrice": 498.90, "fastDeliveryOptions": [], "productCategoryId": 2710, "commission": 13, "businessUnit": "Sports Shoes", "cancelledBy": "", "cancelReason": "", "cancelReasonCode": 0, "defectiveClaimListingInsight": "Kırık ve akma sorunları var" //new field } ], "orderDate": 1762253333685, "identityNumber": "11111111111", "currencyCode": "TRY", "packageHistories": [ { "createdDate": 1762860180000, "status": "Delivered" } ], "shipmentPackageStatus": "Delivered", "status": "Delivered", "whoPays": 1, // If it is a seller pays agreement, 1 comes, if it is a trendyol agreement, this field does not come. "deliveryType": "normal", "timeSlotId": 0, "estimatedDeliveryStartDate": 1762858136000, "estimatedDeliveryEndDate": 1763030936000, "packageTotalPrice": 498.90, "deliveryAddressType": "Shipment", "agreedDeliveryDate": 1762376340000, "fastDelivery": false, "originShipmentDate": 1762242537619, "lastModifiedDate": 1762865408581, "commercial": false, "fastDeliveryType": "", "deliveredByService": false, "warehouseId": 372389, "invoiceLink": "https://efatura01.evidea.com/11111111111", "micro": true, "giftBoxRequested": false, "3pByTrendyol": false, "etgbNo": "25341453EX025864", // When micro is true, information will be returned for the etgbNo field. "etgbDate": 1762646400000, // When micro is true, information will be returned for the etgbDate field. "containsDangerousProduct": false, // In micro export orders, if there are any dangerous products in the package received by the seller, such as batteries, perfume, etc., it will return true. "cargoDeci": 10, "isCod": false, "createdBy": "order-creation", // Indicates how the package was created, can be "order-creation", "split", "cancel" or "transfer" "originPackageIds": null, // This field is populated after cancellation or splitting operations and gives the packageid of the first package after these operations. "hsCode": "711111000000", // This field will return as a string for micro orders. "shipmentNumber": 606404425 } ] }
Starting June 15, 2026, the following fields will also be added to the service response for "Trendyol Yurt Dışı Aracılığı ile" model (this date is currently a draft):
"invoiceNumber": "1255141" "invoiceStatus": "NotInvoiced" "invoiceRejectedReasonKeys: [ { "INVOICE_NUMBER_ALREADY_EXISTS", "INVOICE_TOTAL_MISMATCH" } ]Definitions of "invoiceStatus" field :
invoiceStatus Definition NotInvoiced Indicates that the invoice for the order package has not been sent. Received The invoice for the order package is currently under review. Rejected The invoice for the order package was found to be incorrect/invalid after controls. For order packages in this status: if it is a Türkiye Marketplace order, the incorrect invoice must be deleted from the order package and resent. If it is a Micro-Export or Trendyol Cross-Border Fulfillment order, a new invoice must be provided without sending a delete request for the same order package. Invoiced The invoice for the order package has been verified as correct after controls. The "invoiceLink" field for the order package will be with value only for packages that have transitioned to this status other. For Micro-Export and Trendyol Cross-Border Fulfillment order packages that have not transitioned to this status, cargo labels will not be returned by our integration service.
Definitions of "invoiceRejectedReasonKeys" field:
invoiceRejectedReasonKeys Definition INVOICE_LINE_MISMATCH For each product type in your order, there must be a matching line item containing the correct product quantity, unit price, and VAT information. INVOICE_TOTAL_MISMATCH The grand total amount on your invoice must match the total order amount. INVOICE_LINE_NUMBER_MISMATCH The number of line items on your invoice must match the number of unique product types in the order. INVOICE_TYPE_MISMATCH The invoice type specified on your invoice must be "sales". SENDER_VKN_MISMATCH The sender's Tax Identification Number (VKN) on your invoice must match the VKN defined in the system. RECEIPENT_VKN_MISMATCH The recipient's Tax Identification Number (VKN) on your invoice must match Trendyol's VKN details. INVOICE_NUMBER_MISMATCH The invoice number on your invoice must match the invoice number you provided for the order. INVOICE_DATE_MISMATCH The invoice date must be later than or equal to the order date. INVOICE_SCENARIO_MISMATCH The invoice scenario must be either "basic" or "commercial". INVOICE_NOT_FOUND_IN_MAILBOX The invoice could not be found in the Trendyol mailbox. You are expected to submit a new invoice. INVOICE_NUMBER_ALREADY_EXISTS A previously submitted invoiceNumber is being resent for a different order package. The invoice number must be changed.
Package Status
Service Definition orderDate When the customer creates the order on trendyol.com. Awaiting It returns when the payment is waiting the confirm. (You should not take any action until these orders with this status change to "Created" status. You can use this status only for stock updates.) Created When the payment confirm accepted it returns when the order is ready for shipment. Picking It is a status that can be communicated by you. You can forward it when you start collecting the order or when you start preparing the package. Invoiced This is the status that you can forward to us when you make out an invoice. Shipped Orders that move into transport status are specified in this status. AtCollectionPoint The product is at the relevant PUDO delivery point. The customer is expected to go to the PUDO point and pick it up. Cancelled These are cancelled orders. Also includes unsupplied orders. UnPacked Orders that splitted. Delivered Orders that delivered. No status changes can be made after this status. UnDelivered It returns when the order cannot be delivered to the customer. Returned It returns that the order that does not delivered the customer is returned to the supplier. No status changes can be made after this status. Country code information for micro export orders
Country Country Code Saudi Arabia SA United Arab Emirates AE Qatar QA Kuwait KW Oman OM Bahrain BH Azerbaijan AZ Slovakia SK Romania RO Czechia CZ
Updated 3 days ago