---
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

## Changes

- **2026-08-19** `591c74ba50d8` — 2 warning
  - removed the optional property `items/request` from the response with the `200` status
  - removed the optional property `items/response` from the response with the `200` status
- **2026-08-14** `38f761f66622` — 1 info
  - added the non-success response with the status `400`
- **2026-07-29** `b6e2357aa9c3` — 1 info
  - added the optional property `items/responseHeaders` to the response with the `200` status
- **2026-07-26** `e73ac77ae86d` — 1 info
  - added the new optional `query` request parameter `error`
- **2026-07-20** `e2b32002bad4` — 5 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `method`
  - added the new optional `query` request parameter `offset`
  - added the new optional `query` request parameter `service`
  - …1 more

[Full history](https://skmtc.dev/bavix/apis/gripmock-api-schema/changes/history/get.md)

---

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