---
title: "List your past API requests"
method: POST
path: "/v1/api-requests"
tags: ["API requests"]
---

# List your past API requests

`POST /v1/api-requests`

List the API requests your organization has made, newest first, with the parameters you sent and how each call turned out. Use it to answer 'what did my agent actually run?' — debugging a failed run, auditing usage, or quoting an `errorCode` in a support request. Filter by time range, route, method, status code, or error code, and page through results with `cursor`. History is retained for 7 days; anything older has been purged. Response bodies are not returned — only the request side of each call.

<span>⚡ <strong>Rate limit:</strong> 30 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `from` string, date-time, nullable — Only return requests received at or after this ISO 8601 timestamp. Logs are retained for 7 days, so earlier timestamps simply return nothing.
  - `to` string, date-time, nullable — Only return requests received strictly before this ISO 8601 timestamp.
  - `routePath` string, nullable — Only return requests to this exact route template, e.g. "/v1/person/search".
  - `method` string, nullable — Only return requests using this HTTP method, e.g. "POST".
  - `statusCode` integer, nullable — Only return requests that returned this exact status code.
  - `errorCode` string, nullable — Only return the request carrying this error correlation code.
  - `cursor` string, nullable — The cursor from where to start fetching the next page of results. Provide the `nextCursor` from the previous response to continue from there. Keep the same filters as the call that produced the cursor — reusing a cursor while changing filters silently skips rows.
  - `pageSize` integer — The number of results to fetch per page.

## Response `200`

Default Response

- object
  - `output` object, required
    - `apiRequests` object[], required — Your past API requests, newest first.
      - `id` string, required — Unique id of this logged request. Quote it in support requests to identify a specific call.
      - `organizationId` string, required — Your organization's id.
      - `createdAt` string, date-time, required — When the request was received, as an ISO 8601 timestamp.
      - `method` string, required — HTTP method, e.g. "POST".
      - `routePath` string, required — The route template that handled the request, e.g. "/v1/person/search"
      - `statusCode` integer, required — HTTP status code returned to you.
      - `durationMs` integer, nullable — How long the request took to process, in milliseconds, measured from receipt to just before the response was written.
      - `errorCode` string, nullable — Correlation code included in the response body when a request fails. Quote it in support requests.
      - `request` unknown
    - `nextCursor` string, nullable — The pagination cursor for the next page of results. Null if there are no more results.
    - `hasMore` boolean, required — Whether there are more results to fetch.
    - `retentionDays` integer, required — How many days of request history are retained. Requests older than this have been purged and cannot be returned.
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

## Changes

- **2026-09-01** `f8a78c729da9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fiber/apis/fiber-ai-api/changes/v1/api-requests/post.md)

---

[API](https://skmtc.dev/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.dev/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/f8a78c729da9/schema)