> ## Documentation Index
> Fetch the complete documentation index at: https://docs.isofold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> API reference for interacting with the Isofold query gateway.

<Note>
  This API allows you to programmatically submit queries through Isofold and verify correctness or inspect savings.
  All requests must be authenticated using a Bearer token.
</Note>

## Authentication

Use a Bearer token in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

You can generate keys in the [Isofold dashboard](https://app.isofold.com).

***

## Available Endpoints

<CardGroup cols={2}>
  <Card title="POST /query" icon="terminal" href="/api-reference/endpoint/query">
    Submit a query to be rewritten and executed
  </Card>

  <Card title="GET /cost" icon="dollar-sign" href="/api-reference/endpoint/cost">
    Estimate cost of original vs optimized query
  </Card>

  <Card title="POST /verify" icon="check" href="/api-reference/endpoint/verify">
    Check equivalence between two result sets
  </Card>

  <Card title="Webhook: /query/completed" icon="arrow-right" href="/api-reference/endpoint/webhook">
    Receive query completion + savings event
  </Card>
</CardGroup>