---
title: "EvalGate OpenAPI guide"
description: "Discover and use EvalGate's canonical OpenAPI 3.2 contract from agents, SDK generators, and API clients."
canonical: "https://www.evalgate.com/openapi.json"
last-updated: "2026-08-24"
---

# EvalGate OpenAPI 3.2

The canonical machine-readable API contract is [openapi.json](https://www.evalgate.com/openapi.json). Use it to inspect typed operations, authentication requirements, scopes, request bodies, response schemas, errors, and rate-limit behavior.

## Getting started

1. Read the [authentication walkthrough](https://www.evalgate.com/auth.md).
2. Obtain a scoped organization API key through the [human-approved agent credential handoff](https://www.evalgate.com/agent/setup.md).
3. Download the canonical contract and select operations by their unique `operationId`.
4. Send the API key as `Authorization: Bearer <api-key>` and honor the documented rate-limit headers.

```bash
curl -sS https://www.evalgate.com/openapi.json -o openapi.json
```

- [Developer resource index](https://www.evalgate.com/developers.md)
- [API catalog](https://www.evalgate.com/.well-known/api-catalog)
- [TypeScript SDK and CLI](https://www.npmjs.com/package/@evalgate/sdk)
- [Python SDK](https://pypi.org/project/evalgate-sdk/)