# Groq — API Agent Score

> Score: 85/100 (Grade: A) | Domain: groq.com | Rubric: 1.0.0 | Checked: July 24, 2026

Groq scored 85/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 79/100 (B)
- Agent Understanding: 82/100 (A)
- Agent Usability: 74/100 (B)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 727/729 (100%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 100%, spec 83%.
- [warn] Machine-readable, versioned contract — info.version="2.1" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — Code samples in 3 language(s) across docs (top: python, curl, javascript); 7/18 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 100%, spec 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://console.groq.com/home (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://console.groq.com/docs/quickstart with a runnable first-call sample. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 3 language(s) across docs (top: python, curl, javascript); 7/18 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 71% description completeness (target 90%+). Investigated: spec 100%, sdk 69%.
- [pass] Changelog published — changelog documented in the docs site at https://console.groq.com/docs/changelog. Investigated: spec 100%, docs 100%, sdk 100%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/console_groq, 1990 snippets). Investigated: docs 100%, cli 100%, sdk 92%.
- [warn] Docs reachable, not hard auth-gated — Server ignores Accept: text/markdown header (0/2 pages return markdown). Investigated: docs 75%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 1 pages; 1 failed to fetch. Investigated: docs 44%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://console.groq.com/docs/errors. Investigated: spec 100%, docs 100%, sdk 100%.
- [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 — 1 of 2 pages have content starting past 50% (worst 76%). Investigated: docs 90%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 3 assessed pages (3 JS-rendered). Investigated: docs 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] Rate-limit signaling — rate-limit behavior documented in the docs site at https://console.groq.com/docs/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — Sandbox environments are exposed (sandbox). Investigated: sdk 100%, spec 0%, docs 0%.
- [fail] Pagination documented & consistent — 4 list endpoint(s) exist but no pagination params found. Investigated: spec 0%, docs 0%, sdk 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Groq's API design and overall documentation quality are clear strengths — partners can trust the contract they're building against. The most urgent gaps are in agent understanding and agent usability: there are no machine-readable agent instruction files or structured metadata on the docs, and no runnable collection with test scripts for partners to validate integrations. Closing these gaps should be the immediate priority to ensure partners and their AI agents can discover, understand, and confidently execute against Groq's APIs without friction or manual support.