> ## Documentation Index
> Fetch the complete documentation index at: https://docs.transaction.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# List Prices

> List prices for a product

Get a list of prices for products.

<ParamField path="productId" type="string">
  Filter by product ID
</ParamField>

<ParamField path="page" type="integer">
  Page number
</ParamField>

<ParamField path="limit" type="integer">
  Items per page
</ParamField>

<ParamField path="active" type="boolean">
  Filter by active status
</ParamField>

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data.prices" type="array">
  Array of price objects
</ResponseField>

<ResponseField name="data.pagination" type="object">
  Pagination information
</ResponseField>

## Example Request

```bash theme={null}
curl -X GET "https://api.transaction.gg/merchant/price/list?productId=prod_X4dUuzsMaruQ4UsX&page=1&limit=10" \
  -H "Authorization: Bearer jwt_token"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "prices": [
      {
        "id": "price_i62wKFQ8sGnLxQ5G",
        "productId": "prod_X4dUuzsMaruQ4UsX",
        "amount": "29.99",
        "currency": "USD",
        "active": true,
        "createdAt": "2024-01-01T00:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1
    }
  }
}
```

## Error Responses

<ResponseExample name="Unauthorized">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "status": 401,
      "code": "UNAUTHORISED",
      "message": "Invalid or missing authentication"
    },
    "data": null
  }
  ```
</ResponseExample>