Getting Started

Introduction

The ThredUp API provides a set of REST endpoints that allow you to manage inventory and fulfill orders on ThredUp ↗ platform.

The API accepts requests and returns responses in JSON format, uses standard HTTP response codes, authentication and verbs.

You can use the ThredUp API in the Sandbox environment, which doesn't affect your live data or impact your customers.

How It Works

The typical lifecycle of a ThredUp API order follows these stages:

graph TD
    A[List an Item] --> B[Order Created]
    B -->|Cancel| C[Order Cancelled]
    B -->|Start Fulfilment| D[Order In Transit]
    D --> E[Order Delivered]
    D --> F[Order Returned]
    C -.-> H[Refunds Created]
    E -.-> H
    F -.-> H    

Step 1: List an Item : The partner lists an item on the ThredUp platform.

Step 2: Order Placement : When a customer purchases the item, it is placed into an order. This order appears in available via the API. : The partner can retrieve orders by polling this endpoint or by subscribing to the order webhook.

Step 3: Order Cancellation (Optional) : At this stage, the order may still be canceled, either by ThredUp or the partner.

Step 4: Create a Shipment : If the partner chooses to fulfill the order, it creates one or more shipments. Each shipment includes tracking information, carrier, and fulfillment details.

Step 5: Track Shipment Status : The partner must notify ThredUp of status updates as the shipment progresses (e.g., shipped, delivered) by updating the shipment details.

Step 6: Refunds (Optional) : An order can be refunded at any point after creation, by either ThredUp or the partner. Refunds may be full or partial.