> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/product.md).

# The product object

The product object in the Shortcut API - every field, an example, and the endpoints that return it.

A product in the workspace's catalog.

## Fields

| Field              | Type                   | Description                                                                                         |
| ------------------ | ---------------------- | --------------------------------------------------------------------------------------------------- |
| `id`               | id                     | The product's id.                                                                                   |
| `object`           | `"product"`            | Always `product`.                                                                                   |
| `name`             | string                 | The product's name, unique in the workspace regardless of case.                                     |
| `description`      | string or null         | Description shown on estimates and invoices.                                                        |
| `unitLabel`        | string                 | The unit it is sold in, such as `yard` or `bag`.                                                    |
| `defaultUnitPrice` | number                 | Default price per unit in US dollars.                                                               |
| `taxable`          | boolean                | Whether sales tax applies by default.                                                               |
| `defaultDisplay`   | `itemized`, `included` | `itemized` shows the product as its own line to the customer; `included` folds it into the service. |
| `status`           | `active`, `archived`   | Archived products are no longer offered for new work.                                               |
| `archivedAt`       | timestamp or null      | When the product was archived, ISO 8601 in UTC.                                                     |
| `createdAt`        | timestamp              | When the product was created, ISO 8601 in UTC.                                                      |
| `updatedAt`        | timestamp              | When the product last changed, ISO 8601 in UTC.                                                     |

## Example

```json
{
  "id": "7cf95692-7943-41d9-858d-cd2071d80867",
  "object": "product",
  "name": "Mulch",
  "description": null,
  "unitLabel": "bag",
  "defaultUnitPrice": 42,
  "taxable": true,
  "defaultDisplay": "itemized",
  "status": "active",
  "archivedAt": null,
  "createdAt": "2026-10-16T17:04:12.381Z",
  "updatedAt": "2026-10-16T17:04:12.381Z"
}
```

## Endpoints

| Endpoint                  | What it does     |
| ------------------------- | ---------------- |
| `GET /v1/products`        | List products    |
| `POST /v1/products`       | Create a product |
| `GET /v1/products/{id}`   | Get a product    |
| `PATCH /v1/products/{id}` | Update a product |