# Elastic — API Agent Score

> Score: 81/100 (Grade: A) | Domain: elastic.co | Rubric: 1.0.0 | Checked: July 24, 2026

Elastic scored 81/100 (A), classified "ai-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/elastic)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 81/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 91/100 (A+)
- Developer Experience: 89/100 (A)
- Agent Discovery: 90/100 (A+)
- Agent Understanding: 82/100 (A)
- Agent Usability: 59/100 (D)

## Check Results

### API Design

- [pass] Auth declared & discoverable — authentication documented in the docs site at https://www.elastic.co/docs/deploy-manage/app-connections. Investigated: docs 100%, spec 50%.
- [warn] Schema coverage & depth — 0/17 (0%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 83%, spec 42%.
- [warn] Machine-readable, versioned contract — No info.version and no versioning scheme detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — Code samples present on 1/20 pages across 1 language(s); broader multi-language coverage missing. Investigated: docs 100%, sdk 100%, spec 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://www.elastic.co/downloads (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples present on 1/20 pages across 1 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Description completeness — 82% description completeness (target 90%+). Investigated: spec 100%, sdk 100%.
- [pass] Changelog published — changelog documented in the docs site at https://www.elastic.co/docs/release-notes. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (2 variants scanned starting at https://www.elastic.co/docs/get-started) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (olivere/elastic, 330 snippets). Investigated: docs 100%, sdk 100%, cli 100%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 63%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — No 4xx/5xx response codes (or default error response) documented anywhere in the spec. Investigated: docs 100%, spec 50%, sdk 0%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 4 of 50 pages exceed 100K chars (max 450K). Investigated: docs 75%.
- [warn] Docs structured data — OpenGraph/meta tags only across 6 assessed pages — no JSON-LD for answer engines to cite. Investigated: docs 50%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Pagination documented & consistent — 52 list endpoint(s) exist but no pagination params found. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Elastic's API program is strong overall — the contract, schema quality, documentation discoverability, and developer onboarding are all in excellent shape, giving partners and their agents a solid foundation to build on. The two areas that need immediate attention are agent usability and agent understanding: partners' AI agents lack runnable, test-validated examples to integrate against, and there is no operational guidance for rate-limit handling or pagination, which causes integrations to break in production. Separately, there is no agent instructions file to orient AI agents on how to work with the API, which limits autonomous integration quality. Prioritize making the API executable and operationally reliable for agents first, then close the agent-context gap.