# Metriport Medical API vs Terra API

> Terra scores 65.9 (B) to Metriport Medical's 50.1 (D) for fhir servers. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/metriport-vs-terra
- Markdown: https://www.anchorterminal.com/compare/metriport-vs-terra.md (~2,450 tokens)
- Slim: https://www.anchorterminal.com/compare/metriport-vs-terra.min.md (~680 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/metriport-vs-terra.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-14

Terra API scores 65.9 (B) on agent readiness against Metriport Medical API's 50.1 (D), and leads in 6 of 7 scored categories. Both do fhir servers.

- Metriport Medical API: grade D, 50.1/100, rank #833 of 1076. Markdown https://www.anchorterminal.com/tools/metriport.md · JSON https://www.anchorterminal.com/api/v1/tools/metriport.json
- Terra API: grade B, 65.9/100, rank #327 of 1076. Markdown https://www.anchorterminal.com/tools/terra.md · JSON https://www.anchorterminal.com/api/v1/tools/terra.json
- Best health record and wellness data APIs for AI agents: https://www.anchorterminal.com/best/health-data/index.md
- All 63 health comparisons: https://www.anchorterminal.com/compare/health-data/index.md

## Which one, for what

### Metriport Medical API (D)

Good for: US care providers and digital health companies that need a patient's network records as FHIR with webhooks.

Also in its favour:
- Open source

Watch for: Every API key has full access, including destructive operations, with no scopes

### Terra API (B)

Good for: A fitness, wellness, insurance or research product whose users connect consumer wearables and apps, and an agent that needs to read one user's sleep, activity or body data through MCP.

Ahead on:
- Reliability, 67 against 45
- Schema & documentation, 89 against 65
- Agent ergonomics, 78 against 70
- Security & auth, 65 against 41
- Payments & pricing, 20 against 5

Also in its favour:
- A hosted endpoint, with nothing to install

Watch for: No free tier. Sign-up asks for a plan and billing details, and Quick Start starts at $499 a month with a 30-day money-back guarantee


## Score by category

| Category | Weight | Metriport Medical API | Terra API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 45 | 67 | Terra API +22 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 65 | 89 | Terra API +24 |
| Agent ergonomics | 13% (16.2 this run) | 70 | 78 | Terra API +8 |
| Security & auth | 14% (17.5 this run) | 41 | 65 | Terra API +24 |
| Payments & pricing | 10% (12.5 this run) | 5 | 20 | Terra API +15 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 74 | 75 | Terra API +1 |
| Transparency & trust | 7% (8.8 this run) | 56 | 56 | even |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **50.1 · D** | **65.9 · B** | |

## Facts side by side

| Fact | Metriport Medical API | Terra API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Metriport Inc. | Terra Enabling Developers Inc. |
| Hosted endpoint | no (local only) | `https://access.tryterra.co/api/v2/mcp/<user_id>` |
| Transports | HTTP | HTTP, Streamable HTTP |
| Auth | API key | OAuth or key |
| Pricing | Paid | Pay per use |
| x402 | no | no |
| Licence | Proprietary hosted service under Metriport's terms of use. The source in metriport/metriport is AGPLv3, with an enterprise directory under its own licence, and the @metriport/api-sdk package on npm is MIT | Proprietary service under Terra's terms of service. The OpenAPI specs repository is Apache 2.0 |
| Tools exposed | none | 6 |
| Read-only variant documented | no | no |
| llms.txt | yes | yes |
| Last release | 2026-09-28 | 2026-10-13 |
| Terms last updated | 2024-01-01 | 2026-05-01 |
| Privacy policy last updated | 2023-02-21 | 2023-04-20 |
| Customer content may train models | not found in the text | not found in the text |
| Terms restrict automated access | yes | not found in the text |
| Terms restrict benchmarking | yes | yes |
| Terms or service can change without notice | yes | yes |
| Arbitration or class-action waiver | yes | yes |
| Popularity | 793 stars, 28k npm/wk | 13k npm/wk, 11k PyPI/wk |

## Verdicts

**Metriport Medical API.** One network query pulls a patient's records from HIEs, pharmacies and labs and returns deduplicated FHIR, with per-operation rate limits, RFC 7807 errors and AGPLv3 source. Each API key has full access with no scopes, there are no public prices, and the sandbox opens only after Metriport approves the account.

**Terra API.** Graded on the Unified API and the Terra AI MCP server. A public OpenAPI 3.1 spec, llms.txt, per-user rate limits with Retry-After, and scoped admin tokens with approvals. Access starts at $499 a month with billing details at sign-up, the data API key has no scopes, and API key requests failed for 2 hours 38 minutes on 7 August 2026.

## Before you call either

### Metriport Medical API

1. Check the `errors` array after Start Network Query. It returns 2XX even when some sources fail
2. Wait for `network-query.*` webhooks or poll Get Network Query Status before reading consolidated data, which is cached from the last query
3. Send the resource's `eTag` in `If-Match` on updates to avoid overwriting newer data
4. Keep patient creates under 15 a minute and network queries under 20 a minute per source
5. In sandbox, create patients whose first name matches a pre-defined persona to get example records

### Terra API

1. Send dev-id and x-api-key headers on every Unified API and Terra AI call. A missing header returns 401 problem+json
2. Keep each request window to 1,825 days or less and under 6,000 requested days per user an hour. On 429 with rule r2, wait Retry-After seconds
3. Pass either fields or select to Terra AI tools, never both and never neither, or the call fails with a validation error
4. Expect data by webhook after a user connects through the widget session. REST reads are for backfills and on-demand queries
5. Use the Read only access level for the admin MCP server unless a change is needed. The MCP level can read API keys

## Questions

### Which is better for AI agents, Metriport Medical API or Terra API?

Terra API scores 65.9 (B) on agent readiness against Metriport Medical API's 50.1 (D), and leads in 6 of 7 scored categories.

### Do Metriport Medical API and Terra API need an API key?

Metriport Medical API needs an API key. Terra API takes an API key or an OAuth sign-in.

### Can an agent call Metriport Medical API and Terra API without installing anything?

No hosted endpoint is listed for Metriport Medical API. Terra API has a hosted endpoint at https://access.tryterra.co/api/v2/mcp/<user_id>.

### Are Metriport Medical API and Terra API open source?

Metriport Medical API is open source (Proprietary hosted service under Metriport's terms of use. The source in metriport/metriport is AGPLv3, with an enterprise directory under its own licence, and the @metriport/api-sdk package on npm is MIT). No open-source release is listed for Terra API.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/metriport-vs-terra.json, and with the fewest tokens: https://www.anchorterminal.com/compare/metriport-vs-terra.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "metriport", "b": "terra"}`. From a terminal: `anchor compare metriport terra`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/metriport.json and https://www.anchorterminal.com/api/v1/tools/terra.json

## Other comparisons with Metriport Medical API or Terra API

- [1upHealth vs Terra API](https://www.anchorterminal.com/compare/1uphealth-vs-terra.md)
- [Aidbox vs Metriport Medical API](https://www.anchorterminal.com/compare/aidbox-vs-metriport.md)
- [Aidbox vs Terra API](https://www.anchorterminal.com/compare/aidbox-vs-terra.md)
- [Health Gorilla vs Terra API](https://www.anchorterminal.com/compare/health-gorilla-vs-terra.md)
- [Medplum vs Metriport Medical API](https://www.anchorterminal.com/compare/medplum-vs-metriport.md)
- [Medplum vs Terra API](https://www.anchorterminal.com/compare/medplum-vs-terra.md)
- [Metriport Medical API vs ROOK](https://www.anchorterminal.com/compare/metriport-vs-rook.md)
- [Particle Health vs Terra API](https://www.anchorterminal.com/compare/particle-health-vs-terra.md)
- [Redox vs Terra API](https://www.anchorterminal.com/compare/redox-vs-terra.md)
- [1upHealth vs Metriport Medical API](https://www.anchorterminal.com/compare/1uphealth-vs-metriport.md)
- [Health Gorilla vs Metriport Medical API](https://www.anchorterminal.com/compare/health-gorilla-vs-metriport.md)
- [Medblocks vs Metriport Medical API](https://www.anchorterminal.com/compare/medblocks-vs-metriport.md)
- [Metriport Medical API vs Particle Health](https://www.anchorterminal.com/compare/metriport-vs-particle-health.md)
- [Metriport Medical API vs Redox](https://www.anchorterminal.com/compare/metriport-vs-redox.md)
- [Metriport Medical API vs Zus Health](https://www.anchorterminal.com/compare/metriport-vs-zus-health.md)
- [Medblocks vs Terra API](https://www.anchorterminal.com/compare/medblocks-vs-terra.md)
- [Metriport Medical API vs Validic Inform](https://www.anchorterminal.com/compare/metriport-vs-validic.md)
- [Terra API vs Zus Health](https://www.anchorterminal.com/compare/terra-vs-zus-health.md)
- [ROOK vs Terra API](https://www.anchorterminal.com/compare/rook-vs-terra.md)
- [Terra API vs Validic Inform](https://www.anchorterminal.com/compare/terra-vs-validic.md)