--- title: "Get all orders" method: GET path: "/api/v1/orders/" tags: ["Orders"] --- # Get all orders `GET /api/v1/orders/` ## Request - Base URL: `https://partnerapi-staging.depop.com` - URL: `https://partnerapi-staging.depop.com/api/v1/orders/` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) This endpoint returns all the orders you have received on Depop. **Required OAuth Scope:** `orders_read` It can return a maximum of 200 orders at a time and can be paginated using the `cursor` parameter by providing the `cursor` found in the `meta` object. ## Query parameters - `limit` integer - `cursor` string - `from` string, date-time - `to` string, date-time ## Response `200` A page with orders. This endpoint must be used to reconcile the orders you have received via webhooks. You can do this either by polling the endpoint and using the cursor until you reach an order you have already processed. Alternatively, you can use the `from` and `to` parameters to get orders in a specific time frame. - OrdersPage - `meta` object - `cursor` string - `has_more` boolean - `data` Order[] - `seller_id` number, required: The seller's Depop user ID. - `purchase_id` string, required: Depop's internal purchase ID. Useful to be logged and to report any issues back to us. - `status` 'SHIPPING_PENDING' | 'SHIPPED' | 'REFUNDED' | 'CANCELLED' | 'COMPLETED', required: The status of the order. - `currency` string, required: The currency code of the item's price. - `buyer_pays_amount` string, required: The final amount the buyer paid for the item. This includes the item price considering discounts and offers, shipping cost and any taxes we may need to collect. - `seller_receives_amount` string, required: The amount you'll receive after Depop's fees are deducted. - `buyer_shipping_price` string, required: The shipping price paid by the buyer. - `buyer_tax_amount` string: The tax amount paid by the buyer. This will only be present if tax was collected for the order. - `buyer_address` ShippingAddress, required - `name` string: The name of the buyer. - `address` string: The first line of the buyer's address. - `address2` string: The second line of the buyer's address. - `city` string, required: The city of the buyer's address. - `postal_code` string, required: The postal code of the buyer's address. - `state` string: The state of the buyer's address. - `country_code` string, required: The country code of the buyer's address. - `phone_number` string: The phone number of the buyer. - `line_items` OrderLineItem[], required - `purchase_item_id` number, required: Depop's internal purchase line item ID. Useful to be logged and to report any issues back to us. - `sku` string, nullable: SKU of the product. This field is optional and will be null if no SKU was assigned to the product. - `product_id` number, required: Depop's internal product ID. - `slug` string, required: The unique slug identifier for the product on Depop. - `parcel_id` string, required: Depop's internal parcel ID. Note that multiple line items can share in the same parcel. This is currently true for all buyer orders with multiple items. - `description` string, required: The description of the product. - `original_price` string, required: The original price of the product before any discounts or offers. - `sold_price` string, required: How much it sold for, which includes any discounts or negotiated offers. - `sold_via_offers` boolean, required: Whether the item was sold via an offer negotiation with the buyer. - `image_url` string, required: The URL of the first image of the product. - `seller_fee_breakdown` FeeBreakdown[], required: Breakdown of all fees charged to the seller for this order. - `fee_type` 'PAYMENT_FEE' | 'BOOSTED_FEE' | 'DEPOP_FEE' | 'SHIPPING_FEE', required: The type of fee charged to the seller: - `PAYMENT_FEE`: Payment processing fee - `DEPOP_FEE`: Depop marketplace fee - `BOOSTED_FEE`: Fee for boosted listings (optional) - `SHIPPING_FEE`: Depop Shipping label cost when seller pays for shipping. This will be 0.00 when the buyer pays for shipping label. - `amount` string, required: The amount of the fee. - `currency` string, required: The currency. - `depop_shipping` DepopShippingResponse - `shipping_provider_id` string, required: The identifier for the shipping provider used for this order. Common providers include: USPS, MY_HERMES (EVRI), SENDLE. - `refund_summary` object: Summary of the refund for the order, if applicable. This will only be present if the order has been refunded. - `buyer_refund_amount` string, required: The amount refunded to the buyer. - `seller_refund_amount` string: **DEPRECATED**: This field currently returns incorrect values and should not be relied upon. Please use `breakdown.refunded_to_seller` for accurate seller refund information. - `refund_date` string, date-time, required: The date and time when the refund was processed. - `refunded_by` 'PARTNER' | 'DEPOP', required: Who triggered the refund. Can be either PARTNER or DEPOP. PARTNER indicates the refund was requested by a partner via the API, or in the Depop app. DEPOP indicates the refund was triggered by Depop, for example due to a dispute or if the order was auto-cancelled. - `breakdown` TotalRefundBreakdown, required - `refunded_to_buyer` RefundedToBuyerRefunds, required - `item_refund_amount` string, required: The total amount of item price refunded to the buyer. - `shipping_refund_amount` string, required: The total amount of shipping price refunded to the buyer. - `depop_fee_refund_amount` string, required: The total amount of depop fee refunded to the buyer. - `tax_refund_amount` string, required: The total amount of tax refunded to the buyer. - `refunded_to_seller` RefundedToSellerRefunds, required - `ads_fee_refund_amount` string, required: The total amount of ads fee refunded to the seller. - `payment_fee_refund_amount` string, required: The total amount of payment fee refunded to the seller. - `depop_fee_refund_amount` string, required: The total amount of depop fee refunded to the seller. - `shipping_refund_amount` string, required: The total amount of shipping fee refunded to the seller. This will only be greater than 0 if the seller was responsible for the depop shipping label cost (i.e. free shipping for buyers) and the refund is a total refund. - `created_at` string, date-time, required: The date and time when the order was created. ## Other responses - `400`: Bad request - `401`: Unauthorized - `403`: Forbidden - Insufficient scope --- [API](https://skmtc.dev/depop/apis/seller-api.md) - [All operations](https://skmtc.dev/depop/apis/seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/depop/apis/seller-api/revisions/56fef8e38e44?raw)