Get Invoice Items

get/v1/invoice-items/{invoice_item_id}

Fetches a single invoice line item by its public id within the active workspace. Read only, no side effects. Returns 404 when unknown or out of scope.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
invoice_item_id	string <uuid>	Yes	Public UUID of the invoice item.e.g. 33333333-0000-4000-8000-0000000000d1

Query parameters

Name	Type	Required	Description
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/invoice-items/{invoice_item_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The requested invoice item.

{
  "data": {
    "type": "invoice_item",
    "id": "33333333-0000-4000-8000-0000000000d1",
    "attributes": {
      "line_id": "1",
      "sku": "CLAUDE-API",
      "name": "Claude API tokens",
      "description": "Input and output tokens, April 2026",
      "unit_price": 0.000015,
      "currency": "USD",
      "unit": "token",
      "quantity": 80000000,
      "line_total": 1200,
      "tax_rate": 0,
      "tax_amount": 0,
      "created_at": "2026-04-12T08:00:00Z",
      "updated_at": "2026-04-12T08:00:00Z",
      "deleted_at": null
    },
    "relationships": {
      "invoice": {
        "data": {
          "type": "invoice",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "ledger_account": {
        "data": {
          "type": "ledger_account",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "applied_tax_rate": {
        "data": {
          "type": "tax_rate",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "media": {
        "data": {
          "type": "media",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      }
    }
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}