# Cal.com — API Agent Score

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

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

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

## Summary

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

## Category Scores

- API Design: 84/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 92/100 (A+)
- Agent Understanding: 81/100 (A)
- Agent Usability: 92/100 (A+)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="1.0.0") and header-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — authentication documented in the docs site at https://cal.com/authentication. Investigated: docs 100%, spec 50%.
- [warn] Schema coverage & depth — Only 12% of operations have documented schemas. Investigated: spec 67%, sdk 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [fail] Example coverage — 18% example coverage. Investigated: spec 0%, docs 0%, sdk 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://app.cal.com/signup; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 79% description completeness (target 90%+). Investigated: spec 100%.
- [pass] Changelog published — Newest official SDK activity 1 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Quickstart present — Quickstart page reachable (1 variants scanned starting at https://cal.com/getting-started) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Code samples in docs — No detectable code samples across 19 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 1 pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/cal, 2298 snippets). Investigated: docs 100%, sdk 75%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt contains parseable links but doesn't fully follow the proposed structure: https://cal.com/docs/llms.txt: No blockquote summary found. Investigated: docs 80%.
- [warn] Crawlable / AEO — Sitemap present (7 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 5 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [pass] Agent-navigable, token-efficient docs — All 1 pages contain server-rendered content. Investigated: docs 100%.
- [warn] Operation purpose clarity — 80% of operations are agent-inferable (target 90%+). Investigated: spec 75%.
- [pass] Docs structured data — JSON-LD Article markup on 19/19 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 5% (threshold 35% for full credit).
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.

### Agent Usability

- [pass] Idempotency documented — idempotency documented in the docs site at https://cal.com/docs/api-reference/v2/credits/charge-credits. Investigated: spec 100%, docs 100%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://cal.com/docs/api-reference/v2/bookings-guests/add-guests-to-an-existing-booking. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 71 list endpoint(s). Investigated: docs 100%, spec 75%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://cal.com/sandbox. Investigated: spec 100%, docs 100%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Cal's API program has strong foundations in discovery and schema design, but two areas risk slowing partner adoption and blocking AI agent integration entirely. The most critical gaps are missing runnable examples with test coverage and absent agent-facing instruction context — meaning partners and their coding agents lack the concrete, executable material they need to integrate confidently. Closing these gaps, alongside adding inline code samples and request/response examples to the docs, should be the immediate priority to compress partner onboarding and make Cal's API genuinely agent-ready.