--- title: "Get order details by purchase ID" method: GET path: "/api/v1/orders/{purchase_id}/" tags: ["Orders"] --- # Get order details by purchase ID `GET /api/v1/orders/{purchase_id}/` ## Request - Base URL: `https://partnerapi-staging.depop.com` - URL: `https://partnerapi-staging.depop.com/api/v1/orders/{purchase_id}/` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) This endpoint allows you to get the details of an order by its purchase ID. **Required OAuth Scope:** `orders_read` The purchase ID is the unique identifier for the order and is used in other endpoints to reference this particular order. ## Path parameters - `purchase_id` string, required ## Response `200` A single order - 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 - `404`: Order not found --- [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)