---
title: "List scheduled-task credit usage"
method: GET
path: "/v1/cron-jobs/usage"
tags: ["cron-jobs"]
---

# List scheduled-task credit usage

`GET /v1/cron-jobs/usage`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/cron-jobs/usage`
- Auth: HTTP bearer

Accumulated credits consumed by every run each scheduled task has fired. Creator scoping matches the list route: your own tasks by default, the team view (`mine=false`) for admins. Unlike the list, this is not paginated - it returns one row per visible task.

## Query parameters

- `mine` boolean: When true (default) list only the caller's OWN scheduled jobs. Set false for the team/all view (admins/owners only). That view also includes jobs with no resolved creator.
- `created_by` string, uuid, nullable: Filter to one creator actor id (admins/owners only; others are always scoped to self).

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

One row per visible scheduled task, including tasks that never fired (0).

- CronJobUsageResponse: Accumulated credits for every scheduled job the caller can see.
  - `items` CronJobUsage[], required
    - `cron_job_id` string, uuid, required
    - `credits` integer, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)