---
title: "Reconcile Tool Execution"
method: GET
path: "/tools/executions/by-idempotency-key"
tags: ["Tool Execution"]
---

# Reconcile Tool Execution

`GET /tools/executions/by-idempotency-key`

## Request

- Base URL: `https://qveris.ai/api/v1`
- URL: `https://qveris.ai/api/v1/tools/executions/by-idempotency-key`
- Auth: HTTP bearer

Read a prior paid execution without authorizing another provider call.

## Query parameters

- `key` string, required: Original Idempotency-Key value

## Response `200`

Successful Response

- APIResponseToolExecutionReconciliationData
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` ToolExecutionReconciliationData: Durable state returned for one caller-scoped execution key.
    - `status` 'pending' | 'completed' | 'unavailable', required
    - `execution_id` string, required
    - `execution_state` string, required
    - `provider_request_dispatched` boolean, required
    - `provider_execution_id` string, nullable
    - `charge_event_id` string, nullable
    - `settlement_state` string, required
    - `amount_credits` number, nullable
    - `settlement_batch_id` string, nullable
    - `ledger_entry_id` string, nullable
    - `retry_disposition` 'terminal' | 'reconcile_first', required
    - `response` object, nullable
    - `response_http_status` integer, nullable
    - `result_unavailable_reason` string, nullable
  - `message_key` string, nullable

## Other responses

- `401`: Unauthorized
- `402`: Insufficient credits
- `422`: Validation Error
- `429`: Too Many Requests

---

[API](https://skmtc.dev/qveris/apis/qveris-public-rest-api.md) · [All operations](https://skmtc.dev/qveris/apis/qveris-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qveris/apis/qveris-public-rest-api/revisions/7b78aeef092a?raw)