Amass API Overview

The Amass API gives you programmatic access to Amass Cores — curated and enriched life sciences datasets.

Base URL

https://api.amass.tech/api/v1

Interactive docs: https://platform.amass.tech/api-reference

OpenAPI spec: https://api.amass.tech/api/doc/openapi.json

What are Cores?

Cores are the primary data products in the Amass platform. Each Core covers a distinct domain and exposes its own set of endpoints under /v1/cores/{coreName}/.

All Cores share the same authentication, error format, and rate limits. Endpoints and record schemas are specific to each Core.

Pagination

The API does not support cursor-based or offset pagination. Each search request returns up to 300 results via the limit parameter. To retrieve the most relevant results, use specific queries and filters to narrow your search rather than paging through large result sets.

Shared Endpoint Patterns

Every Core follows the same three-endpoint pattern:

Errors

All errors follow the same shape across all Cores:

{
  "error": {
    "status": 400,
    "code": "BAD_REQUEST",
    "message": "Human-readable description"
  }
}

Validation errors include per-field details:

{
  "error": {
    "status": 400,
    "code": "BAD_REQUEST",
    "message": "Validation failed",
    "in": "query",
    "fields": { "limit": "Must be between 1 and 300" }
  }
}

Rate Limits

Rate limits apply across all Cores.

Default: 60 requests per 60-second window, keyed by user + organization.

Every response includes these headers:

When you hit the limit you get a 429 with a Retry-After header (seconds). Implement exponential backoff — see the Quickstart for an example.

Next Steps

• Quickstart — Make your first API call in under a minute
• Authentication — Set up your API key
• BiomedCore — Search biomedical literature
• TrialCore — Search clinical trials
• DrugCore — Search drugs and molecules
• RegulatoryCore — Search FDA & EMA drug authorizations
• API Workflows — Real-world queries with example responses
• LLM Quick Reference — Compact reference for AI agents