# Get a product

> The products.get operation: GET /api/v1/products/{id} in the REST API and the products_get tool in the MCP server.

Returns one product of the brand's catalog in the request's mode, archived or not: its kind, whether it is
`active`, its entitlements and its pricing-table hints (`displayOrder`, `highlighted`). The brand's pricing
table shows its active products of kind `plan`.

## At a glance

- **REST:** `GET /api/v1/products/{id}`
- **MCP tool:** `products_get`
- **Operation ID:** `products.get`
- **Scope:** Brand
- **Permission:** `catalog:read`
- **Risk tier:** `read`
- **Dry run:** Not supported
- **Idempotency:** Not needed (read only)
- **Modes:** Test and live
- **Authentication:** API key with the `catalog:read` scope
- **Since:** M4

## Request

### Path parameters

| Field | Type        | Description |
| ----- | ----------- | ----------- |
| `id`  | `prod_…` ID |             |

### Query parameters

This operation takes no query parameters.

## Response

`200 OK` with a JSON object:

| Field                       | Type                                                                                                   | Description                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| `id`                        | `prod_…` ID                                                                                            |                                                                                   |
| `object`                    | `"product"`                                                                                            |                                                                                   |
| `brandId`                   | `brd_…` ID                                                                                             |                                                                                   |
| `livemode`                  | boolean                                                                                                |                                                                                   |
| `name`                      | string                                                                                                 |                                                                                   |
| `description`               | string or null                                                                                         |                                                                                   |
| `taxCategoryId`             | one of 9 values, e.g. `electronically_supplied_service`, `saas`, `ebook` (all in the OpenAPI document) |                                                                                   |
| `kind`                      | one of `standard`, `plan`                                                                              |                                                                                   |
| `entitlements`              | array of object                                                                                        |                                                                                   |
| `entitlements[].featureKey` | string                                                                                                 |                                                                                   |
| `entitlements[].value`      | boolean or number or string                                                                            |                                                                                   |
| `lifetimeEntitlements`      | boolean                                                                                                | A one-time purchase of the product grants its entitlements for good (spec §36.1). |
| `displayOrder`              | integer or null                                                                                        |                                                                                   |
| `highlighted`               | boolean                                                                                                |                                                                                   |
| `active`                    | boolean                                                                                                |                                                                                   |
| `images`                    | array of string                                                                                        |                                                                                   |
| `metadata`                  | object                                                                                                 |                                                                                   |
| `createdAt`                 | date-time                                                                                              |                                                                                   |
| `updatedAt`                 | date-time                                                                                              |                                                                                   |

## Examples

### A plan

```http
GET /api/v1/products/prod_01m4tx5nj8emwbyf7y9vcf47y0
Authorization: Bearer or_test_…
```

Response (`200`):

```json
{
  "id": "prod_01m4tx5nj8emwbyf7y9vcf47y0",
  "object": "product",
  "brandId": "brd_01m4tx5nj8emwbyf7y9vcf47x4",
  "livemode": false,
  "name": "Pro",
  "description": "For growing teams.",
  "taxCategoryId": "saas",
  "kind": "plan",
  "entitlements": [
    {
      "featureKey": "seats.max",
      "value": 10
    },
    {
      "featureKey": "feature.export",
      "value": true
    }
  ],
  "lifetimeEntitlements": false,
  "displayOrder": 2,
  "highlighted": true,
  "active": true,
  "images": [],
  "metadata": {},
  "createdAt": "2026-10-13T12:00:00.000Z",
  "updatedAt": "2026-10-13T12:00:00.000Z"
}
```

## Errors

| Code                                                                                     | HTTP status | When                                               | What to do                                                                                           |
| ---------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [`resource_not_found`](https://ownrecord.io/docs/reference/errors.md#resource_not_found) | 404         | No product with this ID is visible to the request. | Check the ID and that your credentials are scoped to the right organization, entity, brand and mode. |
| [`permission_denied`](https://ownrecord.io/docs/reference/errors.md#permission_denied)   | 403         | You can't see this brand's catalog.                | Ask an organization owner or admin for a role or scope that allows this action.                      |

It can also return these [common errors](https://ownrecord.io/docs/reference.md#common-errors): [`validation_failed`](https://ownrecord.io/docs/reference/errors.md#validation_failed), [`api_version_unsupported`](https://ownrecord.io/docs/reference/errors.md#api_version_unsupported), [`authentication_required`](https://ownrecord.io/docs/reference/errors.md#authentication_required), [`api_key_invalid`](https://ownrecord.io/docs/reference/errors.md#api_key_invalid), [`scope_required`](https://ownrecord.io/docs/reference/errors.md#scope_required), [`dry_run_not_supported`](https://ownrecord.io/docs/reference/errors.md#dry_run_not_supported), [`rate_limited`](https://ownrecord.io/docs/reference/errors.md#rate_limited), [`internal_error`](https://ownrecord.io/docs/reference/errors.md#internal_error).