project_configuration:products:read. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
| `expand` | query | no | Specifies which fields in the response should be expanded. Accepted values are: `app` (requires `project_configuration:apps:read` permission), `indicative_price` (requires `project_configuration:products:read` permission). |
**Responses**
- `200` — Success
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | yes | Whether the product is active or inactive (archived). One of: `active`, `inactive` |
| `object` | string | yes | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. One of: `product` |
| `id` | string | yes | The id of the product |
| `store_identifier` | string | yes | The store product identifier |
| `type` | ProductType | yes | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
| `subscription` | SubscriptionProduct | no | |
| `one_time` | OneTimeProduct | no | |
| `created_at` | integer | yes | The date when the product was created in ms since epoch |
| `app_id` | string | yes | The id of the app |
| `app` | App | no | |
| `indicative_price` | IndicativePrice | no | An indicative price for a product, in the default currency/country (USD / US). Uses the same price source as the get-offering-prices endpoint. |
| `display_name` | string | yes | The display name of the product |
subscriptionone_timeappindicative_priceproject_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
| `expand` | query | no | Specifies which fields in the response should be expanded. Accepted values are: `app` (requires `project_configuration:apps:read` permission), `indicative_price` (requires `project_configuration:products:read` permission). |
**Request body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `display_name` | string | no | The display name of the product |
| `type` | ProductType | no | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
**Responses**
- `200` — Success. The product was updated
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | yes | Whether the product is active or inactive (archived). One of: `active`, `inactive` |
| `object` | string | yes | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. One of: `product` |
| `id` | string | yes | The id of the product |
| `store_identifier` | string | yes | The store product identifier |
| `type` | ProductType | yes | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
| `subscription` | SubscriptionProduct | no | |
| `one_time` | OneTimeProduct | no | |
| `created_at` | integer | yes | The date when the product was created in ms since epoch |
| `app_id` | string | yes | The id of the app |
| `app` | App | no | |
| `indicative_price` | IndicativePrice | no | An indicative price for a product, in the default currency/country (USD / US). Uses the same price source as the get-offering-prices endpoint. |
| `display_name` | string | yes | The display name of the product |
subscriptionone_timeappindicative_priceproject_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
**Responses**
- `200` — Success
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | string | yes | The type of the deleted object One of: `app`, `chart_annotation`, `customer`, `discount`, `entitlement`, `experiment`, `offering`, `package`, `paywall`, `product`, `virtual_currency`, `webhook_integration` |
| `id` | string | yes | The ID of the deleted object |
| `deleted_at` | integer | yes | The date when the object was deleted in ms since epoch |
### Archive a product
`POST /projects/{project_id}/products/{product_id}/actions/archive`
Operation ID: `archive-product`
Archives a product (makes it inactive).
This endpoint requires the following permission(s): project_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
**Responses**
- `200` — Success. The product was archived
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | yes | Whether the product is active or inactive (archived). One of: `active`, `inactive` |
| `object` | string | yes | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. One of: `product` |
| `id` | string | yes | The id of the product |
| `store_identifier` | string | yes | The store product identifier |
| `type` | ProductType | yes | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
| `subscription` | SubscriptionProduct | no | |
| `one_time` | OneTimeProduct | no | |
| `created_at` | integer | yes | The date when the product was created in ms since epoch |
| `app_id` | string | yes | The id of the app |
| `app` | App | no | |
| `indicative_price` | IndicativePrice | no | An indicative price for a product, in the default currency/country (USD / US). Uses the same price source as the get-offering-prices endpoint. |
| `display_name` | string | yes | The display name of the product |
subscriptionone_timeappindicative_priceproject_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
**Responses**
- `200` — Success. The product was unarchived
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `state` | string | yes | Whether the product is active or inactive (archived). One of: `active`, `inactive` |
| `object` | string | yes | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. One of: `product` |
| `id` | string | yes | The id of the product |
| `store_identifier` | string | yes | The store product identifier |
| `type` | ProductType | yes | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
| `subscription` | SubscriptionProduct | no | |
| `one_time` | OneTimeProduct | no | |
| `created_at` | integer | yes | The date when the product was created in ms since epoch |
| `app_id` | string | yes | The id of the app |
| `app` | App | no | |
| `indicative_price` | IndicativePrice | no | An indicative price for a product, in the default currency/country (USD / US). Uses the same price source as the get-offering-prices endpoint. |
| `display_name` | string | yes | The display name of the product |
subscriptionone_timeappindicative_priceproject_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `product_id` | path | yes | ID of the product |
**Request body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `store_information` | oneOf | no | Store-specific information for creating the product in the store |
store_informationcreated_productproject_configuration:products:read. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
| `app_id` | query | no | This is an optional query parameter to get a list of products of a given entitlement associated with a particular app |
| `starting_after` | query | no | Pagination cursor. Pass the id of the last item from the previous page to fetch the next page; omit for the first page. |
| `limit` | query | no | Maximum number of items to return per page. Values below 1 or above 100 are clamped to that range rather than rejected. |
| `expand` | query | no | Specifies which fields in the response should be expanded. Accepted values are: `items.app` (requires `project_configuration:apps:read` permission), `items.indicative_price` (requires `project_configuration:products:read` permission). |
**Responses**
- `200` — Success
- `400` — Bad request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Not found
- `423` — Locked
- `429` — The request could not be completed because the rate limiting domain for this endpoint is currently at its limit for this project.
- `500` — Internal server error
- `503` — Internal server error
**Response `200` body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | string | yes | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. One of: `list` |
| `items` | array of Product | yes | Details about each object. |
| `next_page` | string | yes | URL to access the next page of the project's products. If not present / null, there is no next page |
| `url` | string | yes | The URL where this list can be accessed. |
itemssubscriptionone_timeindicative_priceproject_configuration:products:read_write. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.
**Parameters**
| Name | In | Required | Description |
| --- | --- | --- | --- |
| `project_id` | path | yes | ID of the project |
**Request body**
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `store_identifier` | string | yes | The store identifier of the product. - For Apple App Store products this is the product ID of the subscription or in-app product. - For Google's Play Store, it should follow the format 'productId:basePlanId' for subscription products and SKU for one-time purchase products. - For Stripe, the product identifier that always starts with "prod_". RevenueCat selects the active, supported default price when available, or the only active, supported price otherwise. If no price can be selected, the product is created without a web price. For projects that model Stripe products per price, the `store_identifier` in the response is the Stripe price ID when a price is selected. - For Amazon, if it's a subscription, the term SKU of the subscription. If it's a one-time purchase, the SKU of the product. - For Roku, this is the product identifier of the subscription or one-time purchase product. |
| `price_identifier` | string | no | The Stripe price identifier to import. When provided, the price must exist, belong to the Stripe product, and be active and supported. Only supported for Stripe products. |
| `app_id` | string | yes | The ID of the app |
| `type` | ProductType | yes | One of: `subscription`, `one_time`, `consumable`, `non_consumable`, `non_renewing_subscription` |
| `display_name` | string | no | The display name of the product |
| `subscription` | ProductSubscriptionInput | no | Subscription parameters for product creation. Only supported for simulated store products. |
| `title` | string | no | The user-facing title of the product. This field is required for Test Store products. |
subscriptionsubscriptionone_timeappindicative_price