Authentication

Every request to the Amass API requires an API key.

Getting an API Key

1. Sign in at platform.amass.tech
2. Go to API Keys
3. Click Create API Key
4. Copy the key immediately — it starts with amass_ and is shown only once

You can create multiple keys for different applications. Each key can be revoked independently.

Using Your Key

Include the key in the Authorization header on every request:

curl "https://api.amass.tech/api/v1/cores/biomedcore/records?query=CRISPR" \
  -H "Authorization: Bearer amass_YOUR_KEY"

In Python:

import requests

headers = {"Authorization": "Bearer amass_YOUR_KEY"}
response = requests.get(
    "https://api.amass.tech/api/v1/cores/biomedcore/records",
    headers=headers,
    params={"query": "CRISPR"},
)

In R:

library(httr2)

response <- request("https://api.amass.tech/api/v1/cores/biomedcore/records") |>
  req_headers(Authorization = "Bearer amass_YOUR_KEY") |>
  req_url_query(query = "CRISPR") |>
  req_perform()

In JavaScript:

const response = await fetch(
  "https://api.amass.tech/api/v1/cores/biomedcore/records?query=CRISPR",
  { headers: { Authorization: "Bearer amass_YOUR_KEY" } },
)

Error Responses

If you receive a 401, check that:

• The Authorization header is present
• The format is Bearer amass_... (note the space after Bearer)
• The key has not been revoked

Key Management

• Keys are scoped to your user
• Rate limits are per user, not per key — multiple keys for the same user share the same quota
• Revoke compromised keys immediately from API Keys

Next Steps

• Quickstart — Make your first API call
• Pricing — Understand API pricing and plans
• Overview — Error handling and rate limits