# Get product prices

This method allows merchants to retrieve product prices based on the specified filter criteria and pagination settings, returning the results along with pagination information.

Endpoint: GET /products/{product_id}/prices
Version: 1.0.0
Security: MerchantID

## Header parameters:

  - `merchant` (string, required)
    Unique public key provided upon registration and must be shared for identification purposes.
    Example: "api_pk_7b197...ba108f842"

  - `signature` (string, required)
    Signature of request. It allows verifying whether the request from the merchant is genuine on the payment gateway server.
    Example: "M2E3OTkyNzcz...xMmExODI4"

## Path parameters:

  - `product_id` (string, required)
    Unique product identifier.
    Example: "ac43b415-5522-4373-b026-a365462f9657"

## Query parameters:

  - `filter[currency]` (string)
    Specify the comma-separated currencies.
    Example: "EUR, USD"

  - `filter[country]` (string)
    Specify the country code.
    Example: "USA"

  - `pagination[limit]` (integer)
    Specify the number of items to return.
    Example: 10

  - `pagination[offset]` (integer)
    Specify the number of items to skip before starting to collect the result set.
    Example: 10

## Response 200 fields (application/json):

  - `data` (array)
    Contains price data items, each representing a specific price configuration.

  - `data.id` (string, required)
    Unique product price identifier.
    Example: "cb43b415-5522-4373-b026-a365462f9114"

  - `data.default` (boolean, required)
    Indicates whether the price is the default for the product.

  - `data.status` (string, required)
    Product price status.


  Cannot be changed if a subscription exists for the product.
    Enum: "active", "disabled"

  - `data.created_at` (string, required)
    Datetime of the product price creation.
    Example: "2025-05-31 12:53:12"

  - `data.updated_at` (string, required)
    Datetime of the product price update.
    Example: "2025-05-31 12:53:13"

  - `data.product_price` (integer, required)
    Product price.
    Example: 1000

  - `data.trial_price` (integer)
    Trial price.
    Example: 500

  - `data.currency` (string, required)
    Three-letter ISO-4217 currency code of the product price currency.
    Example: "USD"

  - `data.country` (string)
    Country code.


  Not returned or expected for default prices.
    Example: "USA"

  - `pagination` (object)
    Contains information about the pagination of the results.

  - `pagination.offset` (integer, required)
    Starting index of the returned results.
    Example: 20

  - `pagination.limit` (integer, required)
    Maximum number of items to return.
    Example: 10

  - `pagination.total_count` (integer, required)
    Total count of the products available.
    Example: 150

## Response 400 fields (application/json):

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Error code.
    Example: "2.01"

  - `error.message` (string, required)
    Error message.
    Example: "Validation error"

  - `error.constraints` (object)
    Map of constraints.

## Response 401 fields (application/json):

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Error code indicating the specific authorization failure.
    Example: "1.01"

  - `error.message` (string, required)
    Descriptive message providing more details about the authorization failure.
    Example: "Authorization failed"

## Response 403 fields (application/json):

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Error code indicating that access to the service is denied.
    Example: "1.02"

  - `error.message` (string, required)
    Message informing that the service is not allowed for the account.
    Example: "Access denied"

## Response 404 fields (application/json):

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Error code.
    Example: "2.01"

  - `error.message` (string, required)
    Error message.
    Example: "{entityName} not found with id: {entityId}"