Skip to main content
PATCH
/
orders
/
{id}
/
status
Update order status
curl --request PATCH \
  --url https://api.sellfern.com/orders/{id}/status \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "status": "<string>"
}
'
{
  "success": true,
  "data": {
    "id": 1234567890,
    "storeName": "My Etsy Store",
    "date": "2023-11-07T05:31:56Z",
    "currency": "USD",
    "totalAmount": 123,
    "subtotal": 123,
    "tax": 123,
    "shippingCost": 123,
    "discount": 123,
    "customerName": "<string>",
    "customerAddress": "<string>",
    "shipAddress1": "<string>",
    "shipAddress2": "<string>",
    "shipCity": "<string>",
    "shipState": "<string>",
    "shipZipcode": "<string>",
    "shipCountry": "<string>",
    "isGift": true,
    "isRefunded": true,
    "isCaseClosed": true,
    "isLost": true,
    "requiresAudit": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "items": [
      {
        "id": "987654321",
        "orderId": "1234567890",
        "customOrderId": "<string>",
        "name": "<string>",
        "sku": "<string>",
        "customSku": "<string>",
        "spu": "<string>",
        "quantity": 1,
        "price": 123,
        "status": "In Production",
        "assignedSupplier": "<string>",
        "subSupplier": "<string>",
        "material": "<string>",
        "materialId": "<string>",
        "designUrl": "<string>",
        "trackingCode": "<string>",
        "carrier": "<string>",
        "style": "<string>",
        "type": "<string>",
        "size": "<string>",
        "color": "<string>",
        "variations": "<string>",
        "personalization": "<string>",
        "comment": "<string>",
        "idService": "<string>",
        "phone": "<string>",
        "orderDate": "<string>",
        "storeName": "<string>",
        "isGift": true,
        "customerName": "<string>",
        "customerAddress": "<string>",
        "shipName": "<string>",
        "shipAddress1": "<string>",
        "shipAddress2": "<string>",
        "shipCity": "<string>",
        "shipState": "<string>",
        "shipZipcode": "<string>",
        "shipCountry": "<string>",
        "vatIossNumber": "<string>"
      }
    ]
  },
  "meta": {
    "request_id": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-api-key
string
header
required

Sellfern public API key scoped to the authenticated organization. Do not use user JWTs for public integrations.

Headers

Idempotency-Key
string
required

Required for public write retries. Reuse the same key for safe retry after network or 5xx uncertainty. Reusing a key with a different request returns 422 idempotency_conflict.

Required string length: 1 - 255

Path Parameters

id
integer
required

Order ID.

Required range: x >= 1

Body

application/json
status
string
required

Response

Mutation completed successfully.

success
boolean
required
Example:

true

data
object
required
meta
object