---
title: "Get call history"
method: GET
path: "/history"
tags: ["history"]
---

# Get call history

`GET /history`

Returns recorded gRPC calls (when history is enabled)

## Query parameters

- `limit` integer
- `offset` integer
- `service` string
- `method` string
- `error` boolean

## Response `200`

List of recorded calls

- CallRecord[] — A page of recorded calls, newest first.
  - `service` string — Fully qualified gRPC service name.
  - `method` string — gRPC method name.
  - `session` string — Session ID (empty = global)
  - `stubId` string, uuid — Stub identifier
  - `timestamp` string, date-time — When the call was received (RFC 3339).
  - `requests` object[] — Request messages; a unary call carries exactly one
  - `responses` object[] — Response messages; a unary call carries exactly one
  - `responseHeaders` object — Normalized response metadata (header+trailer) the call answered with
  - `code` integer — gRPC status code (e.g., 0 for OK, 5 for NotFound)
  - `error` string — gRPC status message, empty when the call succeeded.
  - `elapsedMs` integer — Handler duration in milliseconds

## Other responses

- `400` — A query parameter could not be parsed, for example a non-numeric `limit`.
- `500` — Internal Server Error

---

[API](https://skmtc.net/bavix/apis/gripmock-api-schema.md) · [All operations](https://skmtc.net/bavix/apis/gripmock-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bavix/gripmock-api-schema/revisions/591c74ba50d8/schema)