Items | Rebill Help Centre

Items are reusable products and services that can be selected when building invoices and quotes. Maintaining a catalog speeds up document creation and keeps your pricing consistent.

List items

GET /item

curl https://rebill-api-896466068278.africa-south1.run.app/item \
  -H "Authorization: Bearer sk_your_secret_key"

Response:

{
  "items": [
    {
      "id": "itm001",
      "name": "Web design",
      "description": "Custom website design",
      "price": 500000,
      "vat_type": "exclusive"
    }
  ]
}

Get an item

GET /item/:id

Returns a single item by ID.

Item object

Field	Type	Description
id	string	Unique identifier
name	string	Item name
description	string	Item description
price	integer	Default unit price in cents
vat_type	string	inclusive · exclusive · none

Create an item

POST /item

Field	Required	Type	Description
name	Yes	string	Item name
description	Yes	string	Item description
price	Yes	integer	Default unit price in cents
vat_type	Yes	string	inclusive · exclusive · none

curl -X POST https://rebill-api-896466068278.africa-south1.run.app/item \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web design",
    "description": "Custom website design and development",
    "price": 500000,
    "vat_type": "exclusive"
  }'

Response (201 Created):

{
  "id": "itm001"
}

Update an item

PUT /item/:id

Updates an item. Accepts the same fields as create. Send all fields; omitted fields will be cleared.

Delete an item

DELETE /item/:id

Permanently deletes an item from your catalog. Existing invoices and quotes that reference this item are unaffected. Returns 200 OK on success.