DEdepop
Orders

Get order details by purchase ID

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.

get/api/v1/orders/{purchase_id}/

Request

Path parameters

purchase_idstring required

The purchase ID of the order.

Response

A single order

seller_idnumber required

The seller's Depop user ID.

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

currencystring required

The currency code of the item's price.

buyer_pays_amountstring 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_amountstring required

The amount you'll receive after Depop's fees are deducted.

buyer_shipping_pricestring required

The shipping price paid by the buyer.

buyer_tax_amountstring

The tax amount paid by the buyer. This will only be present if tax was collected for the order.

created_atstring date-time required

The date and time when the order was created.

Example response

{
  "seller_id": 123456,
  "purchase_id": "123456",
  "status": "SHIPPING_PENDING",
  "currency": "GBP",
  "buyer_pays_amount": "50.99",
  "seller_receives_amount": "45.99",
  "buyer_shipping_price": "5.00",
  "buyer_tax_amount": "3.24",
  "buyer_address": {
    "name": "John Doe",
    "address": "123 Main St",
    "address2": "Apt 1",
    "city": "Los Angeles",
    "postal_code": "90022-3049",
    "state": "CA",
    "country_code": "US",
    "phone_number": "07123456789"
  },
  "line_items": [
    {
      "purchase_item_id": 2385551,
      "sku": "ABC-12345-S-BL",
      "product_id": 7021251,
      "slug": "vintage-nike-t-shirt-7021251",
      "parcel_id": "6e3538ca-6653-3c25-bf0a-a2be876b17e4",
      "description": "Vintage Nike T-Shirt in excellent condition",
      "original_price": "29.99",
      "sold_price": "25.99",
      "sold_via_offers": false,
      "image_url": "https://media-photos-staging.depop.com/b0/18220/5612584_b6795bc34778465293e45647518906d6/P0.jpg"
    }
  ],
  "seller_fee_breakdown": [
    {
      "fee_type": "DEPOP_FEE",
      "amount": "3.00",
      "currency": "GBP"
    },
    {
      "fee_type": "PAYMENT_FEE",
      "amount": "2.00",
      "currency": "GBP"
    }
  ],
  "depop_shipping": {
    "shipping_provider_id": "USPS"
  },
  "refund_summary": {
    "buyer_refund_amount": "12.99",
    "seller_refund_amount": "1.00",
    "refund_date": "2014-03-18T12:00:00Z",
    "refunded_by": "PARTNER",
    "breakdown": {
      "refunded_to_buyer": {
        "item_refund_amount": "15.00",
        "shipping_refund_amount": "3.00",
        "depop_fee_refund_amount": "0.50",
        "tax_refund_amount": "2.00"
      },
      "refunded_to_seller": {
        "ads_fee_refund_amount": "1.50",
        "payment_fee_refund_amount": "0.80",
        "depop_fee_refund_amount": "0.30",
        "shipping_refund_amount": "4.00"
      }
    }
  },
  "created_at": "2025-01-01T12:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.