List products and services

Products and services you can put on an invoice, with price and tax.

GET https://cotlet.dev/api/v1/alegra/items

read

Lists your products and services with the default price and the tax each one carries. Use item_id as the item of an invoice line. A line may override the price, so the price here is the default only. Pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_items
NameTypeDescription
query string string Part of the name or the reference.
limit integer integer Items per page.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/alegra/items \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("alegra", "list_items")
Node.js
const result = await cotlet.call('alegra', 'list_items');
CLI
cotlet call alegra list_items

Example response

JSON

{
  "items": [
    {
      "item_id": "12",
      "name": "Landing page review",
      "reference": "LPR-01",
      "price": 400,
      "tax": {
        "tax_id": "3",
        "name": "IVA 19%"
      }
    },
    {
      "item_id": "15",
      "name": "Setup",
      "reference": "SET-01",
      "price": 150,
      "tax": {
        "tax_id": "3",
        "name": "IVA 19%"
      }
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.