# Ramp — API Agent Score

> Score: 77/100 (Grade: B) | Domain: ramp.com | Rubric: 1.0.0 | Checked: July 24, 2026

Ramp scored 77/100 (B), classified "partially-ready".

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

## Summary

- Overall: 77/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 81/100 (A)
- Developer Experience: 75/100 (B)
- Agent Discovery: 78/100 (B)
- Agent Understanding: 81/100 (A)
- Agent Usability: 71/100 (B)

## Check Results

### API Design

- [pass] Auth declared & discoverable — authentication documented in the docs site at https://docs.ramp.com/llms-guides/ai-usage.txt. Investigated: spec 100%, docs 100%, wellknown 0%.
- [warn] Machine-readable, versioned contract — info.version="v1" 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 100%.
- [pass] Example coverage — README is present and includes a runnable quickstart. Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Schema coverage & depth — Max schema nesting depth: 15 (≥15 = deep). Investigated: spec 33%, sdk 25%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://app.ramp.com/sign-up; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 75% description completeness (target 90%+). Investigated: spec 100%, sdk 8%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.ramp.com/llms-guides/banking.txt. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (10 variants scanned starting at https://docs.ramp.com/quickstart) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (ramp-project/ramp-mobility, 49 snippets). Investigated: docs 100%, sdk 50%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 0/100 sitemap doc pages (0%); 100 missing; 3 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 71%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — 50 of 50 sampled pages return 200 for non-existent URLs (soft 404). Investigated: docs 50%.
- [warn] Crawlable / AEO — Sitemap present (100 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://docs.ramp.com/llms-guides/error-handling.txt. Investigated: spec 100%, docs 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 — No sampled pages support .md URLs (0/50 tested). Investigated: docs 88%.
- [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 20 sampled pages — likely a CSR-only docs site. 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] Rate-limit signaling — rate-limit behavior documented in the docs site at https://docs.ramp.com/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 52 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://docs.ramp.com/llms-guides/sandbox.txt. Investigated: spec 100%, docs 100%, sdk 50%.
- [fail] Idempotency documented — 1% of mutating operations document idempotency. 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

Ramp's API program demonstrates strong foundations in API design and machine-readable contracts, but partners and their AI agents face two critical gaps: there is no structured guidance for agents to understand and act on the API, and no runnable context for agents to build against without guessing. Closing the agent understanding and usability gaps — by publishing an AGENTS.md, structured docs, and a runnable collection with test scripts — will unlock self-serve partner integration and make Ramp's API genuinely agent-ready. Prioritize these before addressing onboarding polish and idempotency documentation.