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

This section defines the transition states of an order and the required partner actions. The lifecycle officially begins once a customer completes a checkout on the ThredUp platform.

graph TD
    Start[Checkout] --> B[Order Created]
    B -->|Cancel| C[Order Cancelled]
    B -->|Start Fulfillment| D[Order In Transit]
    D --> E[Order Delivered]
    D --> F[Order Returned]
    C -.-> H[Settlement / Refund]
    E -.-> H
    F -.-> H    

Step 1: Checkout

A customer purchases a partner listed item on the ThredUp platform.

Step 2: Order Creation

Once checkout is complete, an order is created.

The order becomes available via the API after fraud checks are completed. Partners can retrieve orders by polling the orders endpoint or subscribing to order webhooks.

Step 3: Order Cancellation (Optional)

Before fulfillment begins, the order may be canceled by either ThredUp or the partner.

Step 4: Create a Shipment

To fulfill the order, the partner must create a shipment via the API. Each shipment includes carrier, tracking information, and fulfillment details.

Step 5: Track Shipment Status

Partners must provide shipment status updates (e.g. shipped, delivered) by updating the shipment via the API.

These updates drive the order toward Delivered or Returned states.

Step 6: Refunds (Optional)

Orders may be refunded, fully or partially, after creation. Refunds can be initiated by either ThredUp or the partner and typically occur after cancellation, return, or delivery adjustments.