CommetCommet
GitHubDiscordStatus
Advance test clock POSTGet test clock state GETDeprecated manual billing processing POST
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

Get test clock state

Returns the organization's current test clock state and latest durable run. Sandbox only.

GET
/test-clock

Returns the organization's current test clock state and latest durable run. Sandbox only.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/test-clock"
{  "simulatedTime": "2026-09-07T12:00:00.000Z",  "isActive": true,  "now": "2026-09-07T12:00:00.000Z",  "latestRun": null,  "object": "test_clock",  "livemode": false}
{  "error": {    "type": "validation_error",    "code": "validation_error",    "message": "The request contains an invalid parameter.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md"  }}
{  "error": {    "type": "authentication_error",    "code": "unauthorized",    "message": "A valid API key is required.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md"  }}
{  "error": {    "type": "authentication_error",    "code": "forbidden",    "message": "You do not have permission to perform this operation.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md"  }}
{  "error": {    "type": "rate_limit_error",    "code": "rate_limited",    "message": "Too many requests. Retry after the interval specified in the Retry-After header.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md"  }}
{  "error": {    "type": "internal_error",    "code": "internal_error",    "message": "An unexpected error occurred while processing the request.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md"  }}

Advance test clock POST

Starts a durable run that moves the test clock forward and processes every billing deadline due before the target time. Poll GET /test-clock for progress and terminal results. Sandbox only.

Deprecated manual billing processing POST

Deprecated. POST /test-clock now advances time and processes every due billing deadline in one durable run.