---
title: "List Trials"
method: GET
path: "/billing/org/v1/trials"
tags: ["trials"]
---

# List Trials

`GET /billing/org/v1/trials`

Retrieve a list of `Trial` objects.

You can use query parameters to filter, sort, and paginate the results.

## Query parameters

- `active_after` string, date-time
- `active_at` string, date-time
- `active_before` string, date-time
- `client_id` integer[]
- `company_name` string
- `created_after` string, date-time
- `created_before` string, date-time
- `created_on` string, date
- `id` integer
- `limit` integer
- `not_active_at` string, date-time
- `offset` integer
- `ordering` string[]
- `plan_id` integer[]
- `plan_name` string
- `product_id` integer[]
- `product_internal_name` string[]
- `product_name` string
- `started_at__isnull` boolean

## Response `200`

Request successful.

- PaginatedTrialForOrgSerializerV1List
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` TrialForOrgSerializerV1[], required
    - `id` integer, required
    - `client_id` integer, required — ID of the client associated with the trial.
    - `client` CustomerCommonShort, required
      - `id` integer, required
      - `company_name` string, required
    - `product` ProductCommonShort, required
      - `id` integer, required
      - `name` string, required
      - `internal_name` string, required
    - `plan` PlanCommonShort, required
      - `id` integer, required
      - `name` string, required
    - `days_limit` integer, required — The number of days for which the trial is valid.
    - `active_ranges` DateTimeTZRange[], required — List of active ranges for the trial.
      - `start` string, date-time, nullable
      - `end` string, date-time, nullable
    - `created_at` string, date-time, required — The date and time when the trial was created.
    - `options` TrialOptionForOrgSerializerV1[], required — List of trial options associated with the trial.
      - `internal_name` string, required — Internal name of the trial option.
      - `name` string, required — Name of the trial option.
      - `description` string, required — Description of the trial option.
      - `unit` UnitCommon, required
        - `id` integer, required — Unique internal identifier of the unit.
        - `name` string, required — Name of the unit.
        - `internal_name` string, required — Internal name of the unit.
      - `value` integer, required — Value of the trial option in `unit`.
      - `used_value` integer, required — Used value of the trial option in `unit`. This is the value that has been consumed or utilized during the trial period.
      - `remaining_value` integer, required — Remaining value of the trial option in `unit`. This is calculated as the difference between `value` and `used_value` if the trial option is a limit. If it is not a limit, this field will be `null`.
      - `is_limit` boolean, required — Indicates if the trial option is a limit.
      - `feature` FeatureCommonExternal, required
        - `id` integer, required
        - `name` string, required
    - `remaining_duration` integer, required — Remaining duration of the trial period in seconds. This is calculated as the difference between the end date of the trial and the current time. If the trial has not started or has ended, this field will be `null`.
    - `is_trial_skipped` string, required — Indicates if the trial is skipped.

## Other responses

- `401` — Authentication credentials were not provided or are invalid.
- `403` — You do not have permission to perform this action.

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)