depop Seller API
The Seller API API from depop — 0 operation(s) for seller api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/depop-seller-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: Seller API
version: 1.0.0
description: 'Externally facing API to allow enterprise partners to automate listing on Depop.
## OAuth 2.0 Scopes
This API uses OAuth 2.0 scopes to control access to different resources. Each endpoint requires specific scopes to access:
- **`products_read`** - Required to read product information and listings
- **`products_write`** - Required to create, update, or delete products
- **`orders_read`** - Required to read order information and order history
- **`orders_write`** - Required to mark orders as shipped or process refunds
- **`offers_read`** - Required to read offer pricing information (auto send offer price, auto negotiate offer price)
- **`offers_write`** - Required to set or modify offer prices (auto send offer price, auto negotiate offer price)
- **`shop_read`** - Required to read shop information including seller addresses and available shipping providers
API key tokens have access to all scopes, while OAuth tokens are limited to the scopes specified in the token.
If you attempt to access an endpoint without the required scope, you will receive a `403 Forbidden` response with the error code `insufficient_scope`.'
servers:
- url: https://partnerapi-staging.depop.com
- url: https://partnerapi.depop.com
security:
- BearerAuth: []
tags:
- name: Seller API
paths: {}
webhooks:
newOrder:
post:
summary: '`v1:order.new` New order webhook'
description: 'This webhook is sent whenever a new order is placed on Depop.
The webhook will contain the details of the order, including the buyer''s address and the items purchased.
You can use this webhook to update your inventory and other platforms that the item is no longer available.
Please make sure you''re using the orders endpoint to reconcile the orders you have received via webhooks, as these will have a best effort delivery.'
operationId: newOrderWebhook
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
example:
id: a210923f-c1f3-4d84-a2bd-7f18c68553e2
event_type: v1:order.new
created_at: '2025-01-01T00:00:00Z'
data:
seller_id: 123456
purchase_id: '123456'
status: SHIPPING_PENDING
currency: GBP
buyer_pays_amount: '50.99'
seller_receives_amount: '45.99'
fee_amount: '5.00'
buyer_shipping_price: '5.00'
buyer_address:
name: John Doe
address: 123 Main St
address2: Apt 1
city: London
postal_code: EC1V 4PW
state: Greater London
country: 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 in excellent condition. Black with white swoosh logo on the front.
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
responses:
'200':
description: Acknowledgment
tags:
- Seller API
orderRefunded:
post:
summary: '`v1:order.refund` Order refunded webhook'
description: 'This webhook is sent whenever an order is refunded on Depop.
The webhook will contain the details of the refund, including who refunded (either PARTNER or DEPOP) and the purchase id for the order.'
operationId: orderRefundedWebhook
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
example:
id: a210923f-c1f3-4d84-a2bd-7f18c68553e2
event_type: v1:order.refund
created_at: '2025-01-01T00:00:00Z'
data:
purchase_id: '123456'
refunded_by: PARTNER
responses:
'200':
description: Acknowledgment.
tags:
- Seller API
productLiked:
post:
summary: '`v1:product.like` Product liked webhook'
description: 'This webhook is sent whenever a user likes a product.
You can use this webhook to track engagement with your products and identify which items are popular with buyers.'
operationId: productLikedWebhook
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
example:
id: b320934f-d2g4-5e95-b3ce-8g29d79664f3
event_type: v1:product.like
created_at: '2025-01-01T00:00:00Z'
data:
seller_id: 123456
product_id: 7021251
sku: ABC-12345-S-BL
slug: vintage-nike-t-shirt-7021251
liker_id: 789012
responses:
'200':
description: Acknowledgment.
tags:
- Seller API
productUnliked:
post:
summary: '`v1:product.unlike` Product unliked webhook'
description: This webhook is sent whenever a user unlikes a product.
operationId: productUnlikedWebhook
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Webhook'
example:
id: c431045g-e3h5-6f06-c4df-9h30e80775g4
event_type: v1:product.unlike
created_at: '2025-01-01T00:00:00Z'
data:
seller_id: 123456
product_id: 7021251
sku: ABC-12345-S-BL
slug: vintage-nike-t-shirt-7021251
liker_id: 789012
responses:
'200':
description: Acknowledgment.
tags:
- Seller API
components:
schemas:
WebhookShippingAddress:
required:
- city
- postal_code
- country
type: object
description: 'The buyer''s shipping address as delivered in order webhook payloads.
Note: unlike the Orders endpoint''s address, the country is delivered in the `country` field (not `country_code`).'
properties:
name:
type: string
description: The name of the buyer.
example: John Doe
address:
type: string
description: The first line of the buyer's address.
example: 123 Main St
address2:
type: string
description: The second line of the buyer's address.
example: Apt 1
city:
type: string
description: The city of the buyer's address.
example: London
postal_code:
type: string
description: The postal code of the buyer's address.
example: EC1V 4PW
state:
type: string
description: The state of the buyer's address.
example: Greater London
country:
type: string
description: The country code of the buyer's address.
example: GB
phone_number:
type: string
description: The phone number of the buyer.
example: 07123456789
DepopShippingResponse:
type: object
required:
- shipping_provider_id
properties:
shipping_provider_id:
type: string
description: 'The identifier for the shipping provider used for this order.
Common providers include: USPS, MY_HERMES (EVRI), SENDLE.'
example: USPS
example:
shipping_provider_id: USPS
OrderLineItem:
type: object
required:
- purchase_item_id
- product_id
- slug
- parcel_id
- description
- original_price
- sold_price
- sold_via_offers
- image_url
properties:
purchase_item_id:
type: number
description: Depop's internal purchase line item ID. Useful to be logged and to report any issues back to us.
example: 2385551
sku:
type:
- string
- 'null'
description: SKU of the product. This field is optional and will be null if no SKU was assigned to the product.
example: ABC-12345-S-BL
product_id:
type: number
description: Depop's internal product ID.
example: 7021251
slug:
type: string
description: The unique slug identifier for the product on Depop.
example: vintage-levis-501-jeans-w32-l34
parcel_id:
type: string
description: '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.'
example: 6e3538ca-6653-3c25-bf0a-a2be876b17e4
description:
type: string
description: The description of the product.
example: 'Product 403d667d-eb4d-49fd-aa10-18a54119d9fb created by the RestAssured automated test framework hashtags #vintage #rare #tee #grunge #y2k'
original_price:
type: string
description: The original price of the product before any discounts or offers.
example: '10.00'
sold_price:
type: string
description: How much it sold for, which includes any discounts or negotiated offers.
example: '5.00'
sold_via_offers:
type: boolean
description: Whether the item was sold via an offer negotiation with the buyer.
example: true
image_url:
type: string
description: The URL of the first image of the product.
example: https://media-photos-staging.depop.com/r1/67655700/2147971983_93864b20a2ad4b78833cb92c2154810c/P0.jpg
ProductLike:
type: object
required:
- seller_id
- product_id
- slug
- liker_id
properties:
seller_id:
type: number
description: The Depop user ID of the product seller.
example: 123456
product_id:
type: number
description: The unique identifier of the product.
example: 7021251
sku:
type: string
description: The SKU of the product.
example: ABC-12345-S-BL
slug:
type: string
description: The URL-friendly identifier for the product on Depop.
example: vintage-nike-t-shirt-7021251
liker_id:
type: number
description: The Depop user ID of the user who liked or unliked the product.
example: 789012
Webhook:
type: object
required:
- id
- event_type
- created_at
- data
properties:
id:
type: string
description: The unique identifier of the webhook.
example: a210923f-c1f3-4d84-a2bd-7f18c68553e2
event_type:
type: string
description: The type of event that triggered the webhook.
example: v1:order.new
created_at:
type: string
format: date-time
description: The date and time the webhook was created.
example: '2025-01-01T00:00:00Z'
data:
description: The data of the webhook.
oneOf:
- $ref: '#/components/schemas/OrderWebhook'
- $ref: '#/components/schemas/RefundedOrder'
- $ref: '#/components/schemas/ProductLike'
OrderWebhook:
type: object
required:
- seller_id
- purchase_id
- status
- currency
- buyer_pays_amount
- seller_receives_amount
- fee_amount
- buyer_shipping_price
- buyer_address
- line_items
properties:
seller_id:
type: number
description: The seller's Depop user ID.
example: 123456
purchase_id:
type: string
description: Depop's internal purchase ID. Useful to be logged and to report any issues back to us.
example: '123456'
status:
type: string
description: The status of the order.
anyOf:
- type: string
enum:
- SHIPPING_PENDING
- SHIPPED
- REFUNDED
- CANCELLED
- COMPLETED
example: SHIPPING_PENDING
currency:
type: string
description: The currency code of the item's price.
example: GBP
buyer_pays_amount:
type: string
description: 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.
example: '50.99'
seller_receives_amount:
type: string
description: The amount you'll receive after Depop's fees are deducted.
example: '45.99'
fee_amount:
type: string
description: The total fees charged to the seller for this order.
example: '5.00'
buyer_shipping_price:
type: string
description: The shipping price paid by the buyer.
example: '5.00'
buyer_address:
$ref: '#/components/schemas/WebhookShippingAddress'
line_items:
type: array
items:
$ref: '#/components/schemas/OrderLineItem'
example:
- 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
depop_shipping:
allOf:
- $ref: '#/components/schemas/DepopShippingResponse'
description: 'Depop managed shipping information for this order, if applicable.
This field will only be present if the product was listed with Depop managed shipping.'
example:
shipping_provider_id: USPS
RefundedOrder:
type: object
required:
- purchase_id
- refunded_by
properties:
purchase_id:
type: string
description: Depop's internal purchase ID. Useful to be logged and to report any issues back to us.
example: '123456'
refunded_by:
type: string
description: '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.'
enum:
- PARTNER
- DEPOP
example: PARTNER
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: API key