Get an item

GET/v1/items/{id}

Returns one saved item.

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

get_item

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/items/<id> \
  --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"
  }
}

Authorizations

Authorizationstringrequired

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

Path Parameters

idstring<uuid>required

Id of the item.

Response

200 - application/json

idstring<uuid>

Unique id of the item (uuid v7).

business_idstring<uuid>

The business the item belongs to.

namestring

Name shown on document lines, e.g. Logo design.

descriptionstring | null

Longer text copied to the line description.

skustring | null

Your own stock or product code.

unitstring | null

Unit label such as hour, day or piece.

unit_price_minorstring

Price per unit in minor units of currency, as a string of an integer (e.g. "15000" = 150.00).

currencystring

ISO 4217 currency code, e.g. USD.

default_tax_rate_idstring<uuid> | null

Tax rate applied when the item is added to a line.

archived_atstring<date-time> | null

When the item was archived. Archived items are hidden from pickers but stay on old documents.

created_atstring<date-time>

When the item was created (RFC 3339, UTC).

updated_atstring<date-time>

When the item was last changed.

Suggest edits Raise issue

List itemsPrevious Create or update an itemNext

get_item

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/items/<id> \
  --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"
  }
}