Developers › Docs › API reference › Get an item

Get an item

GET/wp-json/fc/api/v1/items/{vid}

Returns one product and all marketplace listings FLUF can currently see for it. This is what you poll after POST /items returns 202.

curl "https://fluf.io/wp-json/fc/api/v1/items/shopify_8123456789012_0" \
  -H "Authorization: Bearer fluf_pat_your_token"
Response · 200
{
  "vid": "shopify_8123456789012_0",
  "fluf_id": 326428506,
  "title": "Vintage Levi's 501 jeans",
  "sku": "LV-501-32",
  "price": 42,
  "listings": [
    {
      "channel": "ebay",
      "account": "ebay:718",
      "connection_id": 718,
      "listing_id": "123456789",
      "state": "live",
      "listing_url": "https://www.ebay.co.uk/itm/123456789",
      "price": 45,
      "error": null,
      "views": null,
      "likes": null,
      "sold": null,
      "live_at": "2026-08-11T07:15:00Z",
      "created_at": "2026-08-11T07:14:59Z",
      "updated_at": "2026-08-11T07:15:00Z"
    }
  ]
}

Item fields

FieldNotes
vidProduct id to send back to POST /items
fluf_idFLUF internal product id; informational
titleProduct title when the product record is still available
skuSeller SKU when available
priceProduct's own price in FLUF, not a per-account override
photosThe product's photo URLs, in order. GET /items/{vid} only, not the GET /items sweep
listingsOne listing object per marketplace account where this product has state

Listing fields

FieldNotes
channelMarketplace slug
account{channel}:{connection_id} target id
connection_idNumeric account connection id
listing_idMarketplace's own listing id
statePublic listing state
listing_urlBuyer-facing URL when the channel exposes one
pricePrice on this account; may differ from the product price
errorPresent when state is error
viewsLifetime views, or null when unknown
likesFavourites, or null when unknown
soldSale info when FLUF can attribute a sale
live_atWhen the listing went live on the channel, when known
created_atWhen FLUF recorded the listing
updated_atLast recorded listing update

Listing states

StateMeaning
liveVisible to buyers
delistedTaken down
soldSold on this channel
not_visibleDraft, hidden, or paused
out_of_stockListed but unavailable
pendingBeing published
errorChannel refused or could not complete the listing
unknownFLUF has no reliable state

On accounts flagged runs_in_browser, a fresh listing can sit pending until the seller has FLUF open — usually a few minutes (details). A pending listing has no listing_id yet ("") and connection_id may read 0 even on a multi-account seller — neither is known until the channel confirms. Poll again once it resolves to live or error.

When present, sold contains order_id, sold_at, price, and currency. A sold block can appear while state is live if the item sold once and was relisted.

Something missing? Email [email protected] — we prioritise by what people actually ask for.

Scroll to Top