Shop API

Browse catalog products and retrieve your order history from the Flamenet Shop.

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

The Shop API covers the curated product catalog (Flamenet Shop). For the peer-to-peer seller marketplace, see the Marketplace API.

GET /shop/products

Returns a paginated list of published products. Optionally filter by category or search term.

Query parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number.
`per_page`	integer	20	Results per page (max 100).
`category`	string	—	Shop category slug.
`search`	string	—	Full-text search term.

Example request

curl "https://flamenet.io/wp-json/flamenet/v1/shop/products?category=electronics&per_page=10"

Example response

{
  "products": [
    {
      "id":        34,
      "title":     "Palm Pilot III",
      "price":     49.99,
      "sku":       "PALM-III-01",
      "stock":     8,
      "image_url": "https://flamenet.io/wp-content/uploads/palm.jpg",
      "in_stock":  true
    }
  ],
  "total": 23,
  "pages": 3,
  "page":  1
}

Note: stock of -1 means unlimited stock. in_stock is false only when stock equals 0.

GET /shop/products/{id}

Returns full details for a single product, including description and categories.

Example request

curl https://flamenet.io/wp-json/flamenet/v1/shop/products/34

Example response

{
  "id":          34,
  "title":       "Palm Pilot III",
  "price":       49.99,
  "sku":         "PALM-III-01",
  "stock":       8,
  "image_url":   "https://flamenet.io/wp-content/uploads/palm.jpg",
  "in_stock":    true,
  "description": "The classic PDA from Palm Computing...",
  "categories":  [{"id":5,"name":"Electronics","slug":"electronics"}]
}

GET /shop/orders AUTH REQUIRED

Returns all orders placed by the authenticated user.

Example request

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

Example response

{
  "orders": [
    {
      "id":         101,
      "total":      49.99,
      "status":     "paid",
      "items":      [{"id":34,"title":"Palm Pilot III","qty":1,"price":49.99}],
      "created_at": "2026-02-15 13:00:00"
    }
  ],
  "total": 1
}

Order status values: pending, paid, refunded.