# Dub — API Agent Score

> Score: 90/100 (Grade: A+) | Domain: dub.co | Rubric: 1.0.0 | Checked: November 11, 2026

Dub scored 90/100 (A+), classified "ai-ready".

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

## Summary

- Overall: 90/100 (A+)
- Classification: ai-ready

## Category Scores

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

## Check Results

### API Design

- [pass] Auth declared & discoverable — authentication is documented on the docs site at https://dub.co/docs/integrations/quickstart, even though it isn't declared in the API spec. Investigated: spec 100%, docs 100%, mcp 100%, cli 0%.
- [pass] Schema coverage & depth — 563/565 (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 — The API sets a version ("0.0.1") but exposes no versioning scheme in the URL, a header, or the media type, so an agent can't pin to a specific version. Investigated: spec 75%, cli 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, sdk 100%, wellknown 100%.
- [pass] Example coverage — Docs show code samples in 7 language(s) (top: typescript, shell, javascript), and 1 of 20 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%, sdk 100%, spec 0%, cli 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://app.dub.co/register (client-rendered, so its contents couldn't be classified); free tier or sandbox is documented in pricing/docs. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://dub.co/docs/quickstart/server includes a runnable first-call code sample. Investigated: docs 100%.
- [pass] Code samples in docs — Docs show code samples in 7 language(s) (top: typescript, shell, javascript), and 1 of 20 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%.
- [pass] Description completeness — Only 89% of operations and parameters have substantive descriptions (48 of 60 ops, 245 of 249 params; target 90%+). Investigated: spec 100%, sdk 85%.
- [pass] Changelog published — changelog is documented on the docs site at https://dub.co/changelog, even though it isn't declared in the API spec. Investigated: spec 100%, docs 100%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [warn] llms.txt present, valid & comprehensive — llms.txt contains parseable links but doesn't fully follow the proposed structure: https://dub.co/docs/llms.txt: No blockquote summary found. Investigated: docs 97%, sdk 0%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/dub_co, 3140 snippets). Investigated: docs 100%, sdk 83%, cli 0%, mcp 0%, wellknown 0%.
- [pass] Crawlable / AEO — robots.txt lets all monitored AI crawlers reach the docs paths. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Documents 9 distinct 4xx/5xx error response codes, so an agent can branch on specific failures instead of guessing. Investigated: docs 100%, sdk 100%, spec 50%, cli 0%.
- [pass] Operation purpose clarity — 100% of operations (60 of 60) have both a clear summary and a descriptive name, so an agent can pick the right endpoint. Investigated: spec 100%, sdk 100%.
- [warn] Agent-navigable, token-efficient docs — 7 of 50 pages have minor content differences between markdown and HTML. Investigated: docs 100%.
- [pass] Docs structured data — Machine-readable JSON-LD Article markup on 20 of 20 assessed pages (100%), with dateModified present. Investigated: docs 100%.
- [warn] Agent instructions file (AGENTS.md) — No agents.md or skill.md context file found (nice-to-have for agent operation). Investigated: sdk 50%, cli 0%, wellknown 0%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 3 surfaces (spec, docs, sdk) is 6% (threshold 35% for full credit).

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%, cli 0%.
- [pass] Pagination documented & consistent — Pagination parameters are present on the 16 list endpoint(s), so an agent can page through results. Investigated: spec 100%, docs 100%, sdk 17%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [pass] Runnable collection with test scripts — README is present and includes a runnable quickstart. Investigated: sdk 100%, platform 0%.
- [fail] Rate-limit signaling — A 429 response is documented, but no rate-limit response headers accompany it, so an agent can only react to a throttle instead of anticipating one. Investigated: spec 0%, docs 0%.

## Executive Summary

Dub's API program is in strong shape overall — the contract is clean and machine-readable, documentation is discoverable, and agent-facing context is well-structured. The one concrete gap is operational: a 429 response is documented but no rate-limit headers accompany it, leaving partners and their agents with no way to anticipate throttling, only react to it. Closing this single reliability gap will make the API meaningfully safer for autonomous agents running high-frequency workflows at scale.