---
title: "Execute many read-only Coverage Cat tool operations in one request."
method: POST
path: "/api/agent/tools/batch"
---

# Execute many read-only Coverage Cat tool operations in one request.

`POST /api/agent/tools/batch`

## Request

- Base URL: `https://api.coveragecat.com`
- URL: `https://api.coveragecat.com/api/agent/tools/batch`
- Auth: HTTP bearer

Batch the calculator and homeowners-agent-finder APIs into one authenticated call when an agent needs many independent read-only results without looping over individual endpoints.

## Headers

- `Coverage-Cat-API-Version` 'v1'
- `Idempotency-Key` string

## Request body

- ToolBatchRequest
  - `operations` ToolBatchOperation[], required
    - `id` string
    - `input` object, required
    - `tool` 'home_calculator' | 'umbrella_calculator' | 'auto_estimates' | 'collision_and_comprehensive_coverage' | 'file_a_claim' | 'homeowners_agent_finder', required

## Response `200`

Batch completed. Individual operations may still carry per-item errors.

- ToolBatchResponse
  - `error_count` integer
  - `operation_count` integer
  - `results` ToolBatchResult[]
    - `error` ToolBatchError
      - `error` string
      - `message` string
      - `reason` string
    - `id` string
    - `result` object
    - `status` 'ok' | 'error'
    - `tool` 'home_calculator' | 'umbrella_calculator' | 'auto_estimates' | 'collision_and_comprehensive_coverage' | 'file_a_claim' | 'homeowners_agent_finder'
  - `success_count` integer

## Other responses

- `400`: Invalid batch request shape.
- `401`: Invalid or missing operator bearer token.
- `429`: Too many failed authentication attempts or delegated-agent requests. Honor the Retry-After header before retrying.

---

[API](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis.md) · [All operations](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis/revisions/b80fe29790dc?raw)