---
title: "List Mock Tool Data"
method: GET
path: "/v1/mock-tool-data"
tags: ["Mock Tool Data"]
---

# List Mock Tool Data

`GET /v1/mock-tool-data`

## Request

- Base URL: `https://api.sigmamind.ai`
- URL: `https://api.sigmamind.ai/v1/mock-tool-data`
- Auth: API key in header `X-API-Key`

Returns a paginated list of mock tool data records, optionally filtered by agentId and toolId. Sorted by most recently created first.

## Query parameters

- `agentId` string
- `toolId` string
- `page` integer
- `size` integer

## Response `200`

OK

- PaginatedResponseMockToolDataResponse: Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` MockToolDataResponse[]: List of items for the current page. Contains up to 'size' number of records.
    - `mockToolDataId` string: Public identifier of the mock tool data record.
    - `name` string: Human-readable name for this mock.
    - `agentId` string: The unique identifier of the agent this mock belongs to.
    - `toolId` string: Public identifier of the integration tool this mock belongs to.
    - `toolAlias` string: Agent tool alias this mock was created against.
    - `toolName` string: Display name of the tool at the time the mock was created.
    - `request` object: Request payload (or placeholders) associated with this mock.
    - `response` object: Mocked HTTP response body.
    - `statusCode` integer: HTTP status code returned when this mock is used.
    - `delay` integer: Artificial delay in milliseconds before returning the mock response.
  - `page` integer: Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer: Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer: Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer: Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean: Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean: Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `64c0435b10eb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sigmamind/apis/sigmamind-apis/changes/v1/mock-tool-data/get.md)

---

[API](https://skmtc.dev/sigmamind/apis/sigmamind-apis.md) - [All operations](https://skmtc.dev/sigmamind/apis/sigmamind-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmamind/apis/sigmamind-apis/revisions/783c9e4c5126?raw)