---
title: "Retrieve prices based on optional filters"
method: GET
path: "/price"
---

# Retrieve prices based on optional filters

`GET /price`

## Query parameters

- `price_id` string — Filter by a specific price ID
- `plan_ids` string — Filter by comma-separated plan IDs
- `payment_system` string — Filter by payment system (e.g., stripe, paddle, paypal, primer)
- `external_code` string — Filter by external code
- `external_id` string — Filter by external ID from payment system

## Response `200`

Prices retrieved successfully

- Price[]
  - `id` integer
  - `plan_id` integer
  - `external_id` string
  - `external_code` string
  - `currency` string
  - `amount` string
  - `raw_data` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `period` string
  - `period_interval` integer
  - `trial_period_price` string
  - `discount_duration_in_billing_periods` string
  - `trial_free_period_length_in_days` string
  - `phases` object
    - `trial` integer
    - `data` object[]
      - `period` integer
      - `value` integer
      - `price` integer
  - `amount_real` number
  - `discount_percent` number
  - `amount_real_with_discount` number
  - `price_option_text` string
  - `plan` object
    - `id` integer
    - `project_id` integer
    - `payment_system` string
    - `external_id` string
    - `name` string
    - `description` string, nullable

## Other responses

- `404` — No price found

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/revisions/c88545119271/schema)