Explore
3 Explore routes on the FLAM API: What this director holds, and any checkout still open; Every offering this director may see, across all kinds; Take an.
Base URL https://api.flam.fashion. Send Authorization: Bearer flam_sk_… on every call; a handful of routes are session-only and say so. How keys and roles work.
GET /api/toolkit/entitlements
What this director holds, and any checkout still open
holdings is granted only. open is pending-and-unexpired and is returned SEPARATELY so a standing charge is never dressed as a possession.
Responses
| Status | Meaning |
|---|---|
200 | Holdings and open checkouts |
401 | No valid session |
200 returns:
{
"holdings": [
{
"id": "string",
"kind": "string",
"offeringId": "string",
"name": "string",
"source": "purchase",
"priceCents": 0,
"currency": "string",
"paymentRef": "string",
"exclusive": true,
"acquiredAt": "2026-07-27T09:00:00.000Z"
}
],
"open": [
{
"kind": "string",
"offeringId": "string",
"checkoutUrl": "string",
"expiresAt": "2026-07-27T09:00:00.000Z"
}
]
}Call it
curl -X GET "https://api.flam.fashion/api/toolkit/entitlements" \
-H "Authorization: Bearer $FLAM_API_KEY"GET /api/toolkit/explore
Every offering this director may see, across all kinds
Responses
| Status | Meaning |
|---|---|
200 | The board |
401 | No valid session |
200 returns:
{
"offerings": [
{
"kind": "model",
"id": "string",
"name": "string",
"note": "string",
"previewUrl": "string",
"priceCents": 0,
"currency": "string",
"owned": true,
"exclusive": true
}
]
}Call it
curl -X GET "https://api.flam.fashion/api/toolkit/explore" \
-H "Authorization: Bearer $FLAM_API_KEY"POST /api/toolkit/explore/{kind}/{id}/take
Take an offering — free grants now, priced opens checkout
Parameters
| In | Name | Type | Required | Notes |
|---|---|---|---|---|
| path | kind | string | yes | — |
| path | id | string | yes | — |
Responses
| Status | Meaning |
|---|---|
200 | Free — granted; or priced — a hosted checkout url |
401 | No valid session |
409 | TAKEN (an exclusive is claimed) or CHECKOUT_PENDING |
503 | NOT_FOR_SALE or BILLING_NOT_CONFIGURED |
200 returns:
{
"ok": true,
"url": "string",
"pending": true
}Call it
curl -X POST "https://api.flam.fashion/api/toolkit/explore/{kind}/{id}/take" \
-H "Authorization: Bearer $FLAM_API_KEY"