---
title: "List all test clocks"
method: GET
path: "/v1/test_helpers/test_clocks"
---

# List all test clocks

`GET /v1/test_helpers/test_clocks`

Returns a list of your test clocks.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string

## Response `200`

Successful response.

- object
  - `data` TestHelpersTestClock[], required
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `deletes_after` integer, required — Time at which this clock is scheduled to auto delete.
    - `frozen_time` integer, required — Time at which all objects belonging to this clock are frozen.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `name` string, nullable — The custom name supplied at creation.
    - `object` 'test_helpers.test_clock', required — String representing the object's type. Objects of the same type share the same value.
    - `status` 'advancing' | 'internal_failure' | 'ready', required — The status of the Test Clock.
    - `status_details` BillingClocksResourceStatusDetailsStatusDetails, required
      - `advancing` BillingClocksResourceStatusDetailsAdvancingStatusDetails
        - `target_frozen_time` integer, required — The `frozen_time` that the Test Clock is advancing towards.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

## Changes

> 51 revisions in range; 14 not diffed, 6 could not be searched.

- **2025-11-05** `62e8dc4ed869` — 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- **2025-10-22** `1e483c60b480` — 1 info
  - added the optional property `error/payment_intent/amount_details/anyOf[subschema #1: PaymentFlowsAmountDetails]/line_items/data/items/payment_method_options/anyOf[subschema #1: PaymentFlowsAmountDetailsResourceLineItemsListResourceLineItemResourcePaymentMethodOptions]/klarna/subscription_reference` to the response with the `default` status
- **2025-08-19** `7b79777e9bbd` — 2 info
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/location` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/reader` to the response with the `default` status
- …earlier changes not shown

[Full history](https://skmtc.dev/stripe/apis/spec3/changes/v1/test_helpers/test_clocks/get.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) · [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/f0e0fc8fffbf/schema)