# here — API Agent Score

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

here scored 84/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 96/100 (A+)
- Developer Experience: 67/100 (C)
- Agent Discovery: 95/100 (A+)
- Agent Understanding: 82/100 (A)
- Agent Usability: 79/100 (B)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="8.160.0") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — Medium parameter complexity (avg 2.6 params/op; nested/body schemas present). Investigated: spec 83%, sdk 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — 64% example coverage (target 80%+). Investigated: spec 100%, docs 100%, sdk 100%.

### Developer Experience

- [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 — 100% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.here.com/anonymizer/docs/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Quickstart present — Quickstart page reachable (12 variants scanned starting at https://docs.here.com/) but no runnable code sample detected in HTML or .md variant. Investigated: docs 50%.
- [fail] Self-service developer portal — Signup page is sales-gated (contact-sales/request-access language detected). Investigated: docs 0%.

### 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 (websites/here, 2916 snippets). Investigated: docs 100%, cli 100%, wellknown 100%, sdk 50%, mcp 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt is 696,829 characters (exceeds 100,000 threshold; will be truncated by most agents). Investigated: docs 81%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 8 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [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 50 pages have substantive content differences between markdown and HTML (avg 2% missing). Investigated: docs 80%.
- [pass] Docs structured data — JSON-LD Article markup on 11/11 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, docs) is 0% (threshold 35% for full credit).

### Agent Usability

- [pass] Idempotency documented — idempotency documented in the docs site at https://docs.here.com/identity-and-access-management/reference/addprojectresourcerelations. Investigated: spec 100%, docs 100%, sdk 0%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://docs.here.com/identity-and-access-management/docs/how-to-find-rate-limit-rules. Investigated: spec 100%, docs 100%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Here's API program performs well on design fundamentals and agent discovery, but two areas demand immediate attention: agent understanding and partner usability. Partners and their AI agents currently lack the structured context files, consistent descriptions, and runnable examples they need to integrate correctly without guesswork or human support. Prioritize closing the agent-context and description gaps first — these block agents from reliably interpreting your API surface — then add a runnable collection and a self-service portal to compress time to a partner's first successful call.
