---
title: "List your recent calls"
method: GET
path: "/credits/calls"
tags: ["Catalog"]
---

# List your recent calls

`GET /credits/calls`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/calls`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Returns recent calls newest first, with status and credits. Agent connections and OAuth clients see only their own calls. A secret key sees the whole account. Response bodies are never included; use the call result route for those.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'charged' | 'error' | 'all'
- `provider` string

## Response `200`

One page of calls

- object
  - `success` boolean, required
  - `calls` object[], required
    - `call_id` string, required
    - `provider` string, required
    - `endpoint` string, required
    - `status` string, required
    - `credits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `created_at` string, date-time, required
    - `error_summary` string
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid query or cursor
- `401`: Missing or invalid credential

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)