DEdepop
Orders

Get all orders

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.

get/api/v1/orders/

Request

Query parameters

limitinteger

The number of orders to return. Default is 20.

cursorstring

The cursor to start from. This is the ID of the last purchase order ID returned in the previous request.

fromstring date-time

The start date of the orders to return.

tostring date-time

The end date of the orders to return.

Response

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.

Example response

{
  "meta": {
    "cursor": "NDM0NjMyOTI5Njg3",
    "has_more": true
  },
  "data": [
    {
      "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",
        "city": "London",
        "postal_code": "EC1V 4PW",
        "state": "Greater London",
        "country_code": "GB",
        "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",
          "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"
        }
      ],
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Changes

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