Developers
FlipFinch API
Everything in the FlipFinch dashboard is available over a REST API: manage inventory, crosslist to marketplaces, record sales, and pull profit analytics. All endpoints are versioned under /api/v1 and return JSON.
Authentication
Create an API key in Settings → API keys and pass it as a bearer token. Keys are shown once at creation — store them securely.
curl https://flipfinch.com/api/v1/items \ -H "Authorization: Bearer ff_live_YOUR_KEY"
Rate limits
All keys are limited to 60 requests/minute. Monthly quotas depend on your plan:
| Plan | Requests / month |
|---|---|
| Starter | 1,000 |
| Pro | 10,000 |
| Scale | 100,000 |
Exceeding a limit returns 429 with codes rate_limited or quota_exceeded.
Errors
{ "error": { "code": "not_found", "message": "Item not found." } }Items
GET/api/v1/items
List inventory items. Query params: status (draft|listed|sold|archived), limit (default 50, max 200), offset.
POST/api/v1/items
Create an item. Prices are dollars.
{
"title": "Nike Dunk Low Panda",
"brand": "Nike",
"category": "Shoes",
"condition": "Like new",
"size": "10.5",
"color": "Black/White",
"cost": 45,
"price": 120,
"description": "Worn twice, near-mint."
}GET/api/v1/items/:id
Fetch a single item, including its listings.
PATCH/api/v1/items/:id
Update any subset of item fields (same shape as create).
DELETE/api/v1/items/:id
Delete an item and all its listings.
Crosslisting
POST/api/v1/items/:id/listings
Crosslist an item. Marketplace-specific titles and descriptions are generated automatically. Requires the marketplace to be connected in Settings.
{ "marketplaces": ["poshmark", "ebay", "mercari"] }GET/api/v1/listings
List listings. Query params: status, marketplace.
DELETE/api/v1/listings/:id
Delist a listing from its marketplace.
Sales
GET/api/v1/sales
List sales with fees, shipping, cost and net profit per sale.
POST/api/v1/sales
Record a sale. Marks the item sold, computes marketplace fees, and auto-delists every other active listing for the item.
{
"item_id": "itm_...",
"marketplace": "poshmark",
"sale_price": 120, // optional, defaults to item price
"shipping": 7.97 // optional
}Pricing
GET/api/v1/pricing/suggestions
Comparable sold/active prices (anonymized, platform-wide) plus fee-aware suggested list prices per marketplace. Query params: q (keywords), brand, category, base (your market-value estimate in dollars, used when no sold comps match).
GET /api/v1/pricing/suggestions?q=dunk+low+panda&brand=Nike
{
"data": {
"comps": { "sold_count": 4, "sold_median": 122.0, ... },
"market_value": 122.0,
"target_net": 105.9,
"suggestions": [
{ "marketplace": "vinted", "suggested_price": 105.99, "net": 105.99 },
{ "marketplace": "ebay", "suggested_price": 122.99, "net": 105.86 },
{ "marketplace": "poshmark", "suggested_price": 132.99, "net": 106.39 }
]
}
}Analytics
GET/api/v1/analytics/summary
Totals for revenue, fees, cost of goods, expenses and net profit, plus a per-marketplace breakdown. Optional from / to (ISO dates).
Ready to build?
Create an account, generate a key, and make your first call in under a minute.