Marketplace API

Browse storefronts, products, and retrieve your order history from the Flamenet peer-to-peer marketplace.

Base path: /wp-json/flamenet/v1/marketplace

The Marketplace API covers user-owned storefronts (Flamenet Shopping). For the curated catalog, see the Shop API.

GET /marketplace/stores

Returns a list of active seller storefronts.

Query parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number.
`per_page`	integer	20	Stores per page (max 100).

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/marketplace/stores"

Example response

{
  "stores": [
    {
      "id":            3,
      "name":          "RetroTech Surplus",
      "slug":          "retrotech-surplus",
      "status":        "active",
      "description":   "Vintage computing gear from the 90s and 00s.",
      "product_count": 18
    }
  ],
  "page": 1
}

Stripe account IDs and internal financial data are never exposed in this response.

GET /marketplace/stores/{slug}

Returns storefront details and the store's active product listing.

Query parameters

Parameter	Type	Default	Description
`page`	integer	1	Product page number.
`per_page`	integer	20	Products per page (max 100).

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/marketplace/stores/retrotech-surplus"

Example response

{
  "store": {
    "id": 3, "name": "RetroTech Surplus", "slug": "retrotech-surplus",
    "status": "active", "product_count": 18
  },
  "products": [
    {
      "id":        7,
      "title":     "Compaq Presario Keyboard",
      "price":     12.00,
      "stock":     4,
      "in_stock":  true,
      "status":    "active",
      "category":  "Peripherals",
      "image_url": "https://flamenet.io/wp-content/uploads/kb.jpg",
      "store_id":  3
    }
  ],
  "page": 1
}

GET /marketplace/products

Returns a paginated list of active products across all stores.

Query parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number.
`per_page`	integer	20	Results per page (max 100).
`store_id`	integer	—	Filter by store ID.
`category`	string	—	Filter by category name.
`search`	string	—	Search by product title.
`sort`	string	`newest`	Sort order: `newest`, `price_asc`, `price_desc`.

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/marketplace/products?search=keyboard&sort=price_asc"

Example response

{
  "products": [ { "id": 7, "title": "Compaq Presario Keyboard", "price": 12.00, ... } ],
  "page": 1
}

GET /marketplace/products/{id}

Returns full details for a single marketplace product, including store info.

Example request

curl https://flamenet.io/wp-json/flamenet/v1/marketplace/products/7

Example response

{
  "id":        7,
  "title":     "Compaq Presario Keyboard",
  "price":     12.00,
  "stock":     4,
  "in_stock":  true,
  "status":    "active",
  "category":  "Peripherals",
  "image_url": "https://flamenet.io/wp-content/uploads/kb.jpg",
  "store_id":  3,
  "store": {
    "id": 3, "name": "RetroTech Surplus", "slug": "retrotech-surplus",
    "status": "active", "product_count": 18
  }
}

GET /marketplace/orders AUTH REQUIRED

Returns the authenticated user's full marketplace order history, including per-store line items.

Example request

curl https://flamenet.io/wp-json/flamenet/v1/marketplace/orders \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "orders": [
    {
      "id":     55,
      "total":  24.00,
      "status": "paid",
      "items":  [
        {
          "product_id": 7,
          "title":      "Compaq Presario Keyboard",
          "price":      12.00,
          "quantity":   2,
          "store_id":   3,
          "store_name": "RetroTech Surplus"
        }
      ],
      "created_at": "2026-03-01 09:30:00"
    }
  ],
  "total": 1
}

Order status values: pending, paid, completed, refunded, disputed.