List items

GET/v1/items

Returns the saved products and services of the businesses you can reach, newest first.

Use this to fill an item picker or to sync your catalogue. Archived items are left out unless you pass archived=true.

Results use cursor pagination: pass next_cursor from one page as cursor to get the next.

Permission: items.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_items
MCP tool: list_items
CLI: freeinvoiceautomation item list
Available: At launch, 1 January 2027

list_items

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/items \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2a1-7c4e-7b9a-9f10-3c2d1e0a4b51",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "name": "Logo design",
      "description": "Primary logo with two revisions",
      "sku": "DES-LOGO",
      "unit": "piece",
      "unit_price_minor": "45000",
      "currency": "USD",
      "default_tax_rate_id": null,
      "archived_at": null,
      "created_at": "2027-01-04T09:12:44Z",
      "updated_at": "2027-01-04T09:12:44Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

business_idstring<uuid>

Only items of this business. May be left out when you can reach exactly one business.

qstring

Text search over name, description and SKU.

currencystring

Only items priced in this currency.

archivedbooleandefault:false

Set to true to list archived items instead.

sortstringdefault:-created_at

Sort field; a leading - sorts descending.

Available options: name, -name, unit_price_minor, -unit_price_minor, created_at, -created_at

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The items on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Errors

business_out_of_scope

Plus the common errors every call can return. See Errors.

Suggest edits Raise issue

Get client creditPrevious Get an itemNext

list_items

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/items \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2a1-7c4e-7b9a-9f10-3c2d1e0a4b51",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "name": "Logo design",
      "description": "Primary logo with two revisions",
      "sku": "DES-LOGO",
      "unit": "piece",
      "unit_price_minor": "45000",
      "currency": "USD",
      "default_tax_rate_id": null,
      "archived_at": null,
      "created_at": "2027-01-04T09:12:44Z",
      "updated_at": "2027-01-04T09:12:44Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}