> ## Documentation Index > Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List model calls > The workspace's calls to the inference API, newest first, kept 30 days. An API key or an agent reads its own environment; a key made for coding agents (inference only) gets 403. Each failed call says what happened and what to do next. ## OpenAPI ````yaml /api-reference/openapi.json get /requests openapi: 3.1.0 info: title: Runcrate API version: 1.0.0 summary: OpenAI-compatible inference API + GPU infrastructure API. description: >- Runcrate exposes two API surfaces. The inference API at `https://api.runcrate.ai/v1` is OpenAI-compatible: it accepts the standard OpenAI SDK with the base URL changed. The infrastructure API at `https://www.runcrate.ai/api/v1` manages GPU instances, jobs, persistent volumes, environments, SSH keys, templates, and billing. Both share a single `rc_live_*` API key. Pricing is per-token, per-image, per-second, or per-minute on the inference API (varies by model; see https://www.runcrate.ai/api/models/catalog for live rates) and per-second on GPU rentals (see https://www.runcrate.ai/pricing for hourly rates per GPU class). All infrastructure API responses are wrapped in `{ "data": ... }`. List responses also include a `meta` object with pagination cursors. Error responses use `{ "error": { "code": "...", "message": "..." } }`. termsOfService: https://www.runcrate.ai/terms contact: name: Runcrate url: https://www.runcrate.ai/contact license: name: Proprietary url: https://www.runcrate.ai/terms servers: - url: https://api.runcrate.ai/v1 description: Inference API (OpenAI-compatible) - url: https://www.runcrate.ai/api/v1 description: >- Infrastructure API (instances, jobs, storage, environments, ssh-keys, templates, billing) security: - ApiKeyAuth: [] tags: - name: Chat description: OpenAI-compatible chat completions. - name: Messages description: Anthropic-compatible Messages API, for Claude Code and the Anthropic SDKs. - name: Responses description: >- OpenAI-compatible Responses API, for Codex and responses.create. Nothing is stored. - name: Images description: Text-to-image generation. - name: Videos description: Async text-to-video and image-to-video generation. - name: Audio description: Text-to-speech and speech-to-text. - name: Embeddings description: Vector embeddings for RAG and search. - name: Models description: Model catalog discovery. - name: Instances description: GPU instance lifecycle. - name: Jobs description: >- Run one command on its own GPU machine. The machine stops, and billing ends, when the command exits. - name: Schedules description: >- Start an instance or a job later: once at a set time, or on a repeating cron schedule in your timezone. - name: Storage description: Persistent volume management. - name: Environments description: Resource isolation containers within a workspace. - name: Secrets description: >- Names of the secrets an environment's machines get. Values are set in the dashboard and never returned. - name: SSH Keys description: SSH key management for instance access. - name: Templates description: Pre-built instance images and configurations. - name: Billing description: Credit balance, transactions, usage metrics. - name: Model calls description: >- The log of calls to the inference API, kept 30 days: outcome, timing, tokens, cost, end user, session and tags. Never the prompt or the answer. paths: /requests: servers: - url: https://www.runcrate.ai/api/v1 get: tags: - Model calls summary: List model calls description: >- The workspace's calls to the inference API, newest first, kept 30 days. An API key or an agent reads its own environment; a key made for coding agents (inference only) gets 403. Each failed call says what happened and what to do next. operationId: listRequests parameters: - name: from in: query required: false schema: type: string format: date-time description: 'Start, ISO 8601. Default: 24 hours ago; at most 30 days back.' - name: to in: query required: false schema: type: string format: date-time description: 'End, ISO 8601. Default: now.' - name: model in: query required: false schema: type: string description: Only calls to this model id. - name: key in: query required: false schema: type: string format: uuid description: Only calls made with this API key id. - name: environment in: query required: false schema: type: string description: An environment name (a signed-in member only; a key reads its own). - name: outcome in: query required: false schema: type: string enum: - ok - error description: '`ok` or `error`.' - name: endpoint in: query required: false schema: type: string enum: - chat - completions - embeddings - images - videos - speech - transcriptions - messages - responses description: Only calls to this endpoint. - name: end_user in: query required: false schema: type: string description: Only calls sent with this end user. - name: session in: query required: false schema: type: string description: Only calls sent with this `X-Runcrate-Session`. - name: tag in: query required: false schema: type: array items: type: string style: form explode: true description: '`key=value`. Repeat for several; a call must have every one.' - name: request_id in: query required: false schema: type: string description: One request id. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 50 description: How many (default 50). - name: cursor in: query required: false schema: type: string description: '`meta.cursor` of the previous page.' responses: '200': description: A page of calls. content: application/json: schema: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/InferenceRequest' meta: type: object properties: cursor: type: - string - 'null' hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': $ref: '#/components/responses/ValidationError' components: schemas: InferenceRequest: type: object description: >- One call to the inference API, as the request log keeps it. Metadata only: never the prompt or the answer. required: - id - created_at - endpoint - status - outcome - took_ms properties: id: type: string description: 'The request id: the `X-Request-Id` header of the answer.' created_at: type: string format: date-time endpoint: type: string enum: - chat - completions - embeddings - images - videos - speech - transcriptions - messages - responses model: type: - string - 'null' status: type: integer description: The HTTP status the call was answered with. outcome: type: string enum: - ok - error description: '`error` for an HTTP error, or a stream that broke or was cut short.' error: type: - object - 'null' properties: code: type: - string - 'null' message: type: string description: What happened, in plain words, and whether anything was billed. api_said: type: - string - 'null' description: The API's own words, for an input error. next_step: type: string description: What to do about it. took_ms: type: integer description: From the call arriving to the end of the answer. ttft_ms: type: - integer - 'null' description: Time to first token, for a streamed answer. tokens: type: object properties: input: type: - integer - 'null' cached: type: - integer - 'null' cache_write: type: - integer - 'null' output: type: - integer - 'null' reasoning: type: - integer - 'null' tokens_per_second: type: - number - 'null' description: >- Output tokens a second after the first token, for a streamed text answer. finish_reason: type: - string - 'null' description: >- Why the model stopped, as the answer said (`stop`, `length`, `tool_calls`, `end_turn`...). tool_calls: type: - integer - 'null' description: Tool calls the answer asked for. cost: type: - string - 'null' description: What the call was billed, in USD, exact. free: type: - boolean - 'null' stream: type: boolean source: type: string enum: - api - playground - messages - responses environment_id: type: - string - 'null' format: uuid api_key_id: type: - string - 'null' format: uuid end_user: type: - string - 'null' description: OpenAI's `user` body field, or Anthropic's `metadata.user_id`. session: type: - string - 'null' description: The `X-Runcrate-Session` header. tags: type: - object - 'null' additionalProperties: type: string description: The `X-Runcrate-Tags` header. Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: >- Machine-readable error code (e.g. `validation_error`, `unauthorized`, `not_found`, `insufficient_credits`, `rate_limited`, `internal_error`). message: type: string description: Human-readable error message. details: type: object additionalProperties: true description: Optional structured error context. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Authenticated but not permitted for this resource. content: application/json: schema: $ref: '#/components/schemas/Error' ValidationError: description: Request shape or values failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- Use a Runcrate API key with the `rc_live_*` prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.