Developers › Docs › API reference › List drafts
List drafts
Listings waiting on you. A failed draft is one a marketplace refused for something an edit fixes — a size it doesn't accept, a brand or category it couldn't match, a price out of range, wording it won't allow — and reason says which. A pending_review draft is one you asked to review before it goes live.
curl "https://fluf.io/wp-json/fc/api/v1/drafts?status=failed&channel=ebay" \
-H "Authorization: Bearer fluf_pat_your_token"const res = await fetch("https://fluf.io/wp-json/fc/api/v1/drafts?status=failed&channel=ebay", {
headers: {
"Authorization": "Bearer fluf_pat_your_token",
},
});
const data = await res.json();import requests
res = requests.get(
"https://fluf.io/wp-json/fc/api/v1/drafts?status=failed&channel=ebay",
headers={
"Authorization": "Bearer fluf_pat_your_token",
},
)
data = res.json()<?php
// composer require guzzlehttp/guzzle
$client = new GuzzleHttp\Client();
$res = $client->request('GET', 'https://fluf.io/wp-json/fc/api/v1/drafts?status=failed&channel=ebay', [
'headers' => [
'Authorization' => 'Bearer fluf_pat_your_token',
],
]);
$data = json_decode((string) $res->getBody(), true);{
"drafts": [
{
"id": 8812,
"vid": "fluf_326428506_0",
"fluf_id": 326428506,
"title": "Carhartt WIP Detroit Jacket",
"channel": "ebay",
"account": "ebay:718",
"status": "failed",
"origin": "autolist",
"created_at": "2026-09-26 14:02:11",
"reason": { "code": "size_invalid", "message": "\"Other\" is not a valid value for Size." },
"fields": {
"title": { "label": "Title", "type": "text", "editable": true, "value": "Carhartt WIP Detroit Jacket" },
"size": { "label": "Size", "type": "text", "editable": true, "value": "Other", "hint": "eBay size for this category" },
"price": { "label": "Price", "type": "currency", "editable": true, "value": "85.00", "currency": "GBP" }
}
}
],
"page": 1, "per_page": 50, "total": 1,
"by_channel": { "ebay": 1, "vinted": 3 }
}Query parameters
| Parameter | Notes |
|---|---|
status | failed, pending_review, or open (the default — both) |
channel | Marketplace slug, e.g. ebay |
search | Free-text search |
page, per_page | Paging. per_page max 100 |
Fields
fields holds every value the listing will carry; only the ones with editable: true accept a change, and a select field lists its options. A draft leaves this list on its own once the item is live on that marketplace.
Related
GET /drafts/{id} returns one draft; DELETE /drafts/{id} dismisses it without sending. POST /drafts/{id}/approve corrects and sends it.
Something missing? Email [email protected] — we prioritise by what people actually ask for.
