{ "opencollection": "1.0.0", "info": { "name": "Seller API status Products - By SKU API", "version": "1.0.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Products - By SKU", "type": "folder" }, "items": [ { "info": { "name": "Get product details by SKU", "type": "http" }, "http": { "method": "GET", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "The SKU of the product." } ] }, "docs": "This endpoint allows you to get the details of a product by its SKU.\n**Required OAuth Scopes:** - `products_read` - Required to access product information - `offers_read` - Optional. Required to include offer pricing information (`auto_send_offer_price`, `auto_negotiate_offer_price`) in the response. If this scope is not provided, these fields will be omitted from the response.\n\nThe SKU is the unique identifier for the product and is used in other endpoints to reference this particular product.\n" }, { "info": { "name": "Create or update a listing on Depop", "type": "http" }, "http": { "method": "PUT", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product. Must be unique. It can't be reused.\nThis SKU will be used in other endpoints to reference this particular product and also in the webhooks." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint allows you to create or update a new listing on Depop. The product will be available for sale immediately.\n**Required OAuth Scopes:** - `products_write` - Required for all product operations - `offers_write` - Required when setting `auto_send_offer_price` or `auto_negotiate_offer_price`\n#### Creating vs. Updating a Listing\n- **Creating a listing:** If the provided `sku` does not exist, a new product listing will be created.\n\n- **Updating a listing:** If the provided `sku` already e" }, { "info": { "name": "Patch an existing product on Depop", "type": "http" }, "http": { "method": "PATCH", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint allows you to patch an `ON SALE` products fields on Depop.\nIf you want to restock a product, call the PUT endpoint with the same SKU with the available quantity.\n**Required OAuth Scopes:** - `products_write` - Required for all product operations - `offers_write` - Required when setting `auto_send_offer_price` or `auto_negotiate_offer_price`" }, { "info": { "name": "Delete a product on Depop", "type": "http" }, "http": { "method": "DELETE", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product." }, { "name": "fail_if_active_offers", "value": "true", "type": "query", "description": "If set to `true`, the delete will fail with a 409 Conflict error if the product has any active offers. If set to `false` or omitted, the product will be deleted regardless of active offers.\n\n**Note:** This is a temporary flag until insights are available to help you manage active offers. If you plan to use this feature, please let us know so we can understand your use case and ensure a smooth transition when insights become available." } ] }, "docs": "This endpoint allows you to delete a product on Depop. The product will no longer be available for sale and will be removed from your shop. This endpoint is idempotent - it will return a successful response (200) even if the product doesn't exist.\n**Required OAuth Scope:** `products_write`" }, { "info": { "name": "Mark a product as sold", "type": "http" }, "http": { "method": "POST", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/mark-as-sold/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product." } ] }, "docs": "This endpoint allows you to mark a product as sold on your Depop shop. The product will no longer be available for sale but it will still be visible in your shop with a \"sold\" overlay.\n**Required OAuth Scope:** `products_write`\nYou're expected to call this as soon as you make a sale on a different platform. You don't need to call this if the product sells on Depop.\nIf the product is not in a selling state, this endpoint will still return successfully but will remain in the same state." }, { "info": { "name": "Trigger a purchase of a product by SKU (for testing)", "type": "http" }, "http": { "method": "POST", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/purchase/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product." } ] }, "docs": "This endpoint allows you to trigger a purchase of a product on Depop using its SKU. This is useful if you want to test the purchase flow.\nThe product will be sold to a test user and the purchase will be visible in your orders. You will also receive a webhook for the purchase.\nThis endpoint is only available in the staging environment." }, { "info": { "name": "Submit an offer for a product by SKU", "type": "http" }, "http": { "method": "POST", "url": "https://partnerapi-staging.depop.com/api/v1/products/by-sku/:sku/offer/", "params": [ { "name": "sku", "value": "ABC-12345-S-BL", "type": "path", "description": "SKU of the product." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint allows you to submit an offer on behalf of a seller to a specific buyer for a product using its SKU. The offer will be sent to the specified buyer. You can only send offers to buyers who have shown interest in your products (likes, bags, messages)\n**Required OAuth Scope:** `offers_write`\n\n#### Validation Rules\nThe following validations are enforced:\n- **Offer value:** Must be at least 5% lower than product price_amount - **Currency:** Must match the product's currency exactly - **S" } ] } ], "bundled": true }