# GET /v1/catalogue/products/{productId}

**Service:** Catalogue  
**Operation:** `CatalogueService_GetProduct`

Returns the full product, including all of its priced variant rows.

## Parameters

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `productId` | path | string | yes | The id of the product to retrieve. Required. |
| `fields` | query | string | no | Comma-separated response fields to include, using camelCase JSON names (e.g. `orderId,total.amountMicros`). Dot paths reach into nested objects and map transparently across arrays. Paths are relative to the resource, not the response envelope; envelope keys like `nextPageToken` are always preserved. Only 2xx JSON responses are filtered; error bodies pass through unmodified. Unknown names are silently ignored. Takes precedence over `excludeFields` when both are provided. |
| `excludeFields` | query | string | no | Comma-separated response fields to exclude, using camelCase JSON names. Dot paths and array-transparency work the same as `fields`. Paths are relative to the resource, not the response envelope. Only 2xx JSON responses are filtered; error bodies pass through unmodified. Ignored when `fields` is also provided. |

## Responses

| Status | Schema | Description |
| --- | --- | --- |
| 200 | `GetProductResponse` | A successful response. |
| 400 | `Error` | The request was rejected because it was malformed — for example a badly formed id. The body is a validation-failure envelope: an overall type and message and one entry per problem (each with a stable code, a message, and a param pointing at the offending parameter). |
| 401 | `Error` | The request is missing a valid bearer token, or the token is invalid or expired. |
| 403 | `Error` | The token is valid but does not permit this action, or the resource belongs to a company the token cannot act for. The error type is permission_denied. |
| 404 | `Error` | No catalogue product with the given id exists for the authenticated company. |
| 429 | `Error` | The request was throttled (rate_limited) or exceeded a size limit (resource_exhausted). When throttled, the Retry-After header says how many seconds to wait before retrying; a resource_exhausted request will fail the same way if retried unchanged. |
| default | `Error` | Any other error. The body is the same error envelope every error uses: a short stable type identifying the kind of failure (for example "rate_limited" or "internal"), a human-readable message, and the request's idempotency key echoed back when one was supplied. |

## Returns

`GetProductResponse`

| Field | Type | Description |
| --- | --- | --- |
| `product` | Product | The requested product. |
| `product.productId` | string | The product's unique id. Use this to reference the product on a line item. |
| `product.name` | string | The product's display name. Not guaranteed unique; not a lookup key. |
| `product.categoryId` | string | The id of the category this product belongs to. |
| `product.categoryName` | string | The display name of the product's category. |
| `product.pricingStrategy` | PricingStrategy | How this product's quantity is interpreted for pricing. How a quantity is interpreted for pricing — whether it means a count of each, a length, or an area.  On a catalogue product this is the product's pricing basis. On an order or quote line, measurement-based strategies (lineal or square metres/feet) require the line's measurement details to be supplied.   - PRICING_STRATEGY_UNSPECIFIED: Unset, or a legacy product with no pricing strategy recorded.  - PRICING_STRATEGY_BASIC_QUANTITIES: Quantity is a simple per-each count.  - PRICING_STRATEGY_LINEAL_METRES: Quantity is a length in lineal metres.  - PRICING_STRATEGY_CUSTOM_FORMULA: Quantity is priced by a custom formula.  - PRICING_STRATEGY_SQUARE_METRES: Quantity is an area in square metres.  - PRICING_STRATEGY_LINEAL_FEET: Quantity is a length in lineal feet.  - PRICING_STRATEGY_SQUARE_FEET: Quantity is an area in square feet. One of: PRICING_STRATEGY_UNSPECIFIED, PRICING_STRATEGY_BASIC_QUANTITIES, PRICING_STRATEGY_LINEAL_METRES, PRICING_STRATEGY_CUSTOM_FORMULA, PRICING_STRATEGY_SQUARE_METRES, PRICING_STRATEGY_LINEAL_FEET, PRICING_STRATEGY_SQUARE_FEET. |
| `product.isTaxFree` | boolean | Whether this product is exempt from tax. |
| `product.rows` | ProductRow[] | The product's priced variant rows. |
| `product.rows.productRowId` | string | The variant row's unique id. Reference this on a catalogue line item. |
| `product.rows.colour` | string | The variant's own colour. Usually empty — colour is normally chosen per line from `colourOptions` rather than baked into the row. |
| `product.rows.thickness` | string | The variant's thickness. |
| `product.rows.attributes` | RowAttribute[] | Additional attribute pairs that identify this variant, e.g. [{name:"Size", value:"A4"}]. |
| `product.rows.markedUpPrice` | Money | The computed marked-up sell price, for reference. |
| `product.rows.prices` | RowPrice[] | The variant's price at each of your price levels. |
| `product.rows.colourOptions` | string[] | The colours a catalogue line built on this row may use, when the product's material offers a colour selection. A line's colour must be one of these. They come from the row's material, so every row sharing that material offers the same colours; the list is empty when the product has no colour choice. Colour is the per-line choice — the attributes above identify the variant. |
| `product.isInventoryTracked` | boolean | Whether this product participates in inventory tracking. When true, stock levels for its rows are available from the Inventory API. |

---

Source: https://developer.factory.app/reference/catalogue/get-product · Factory Sales API v1