Pricing
The Amass API is usage-based. You pay for what you use with no upfront commitments.
Cost Per Request
| Endpoint | Cost |
|---|---|
Search (GET /cores/{core}/records) | $0.05 per 20 results. Cost scales linearly with limit — e.g. limit=100 costs $0.25 (5 × $0.05). |
Get by ID (GET /cores/{core}/records/{amassId}) | $0.01 per request |
Lookup (POST /cores/{core}/records/lookup) | $0.01 per request |
Change feed (GET /cores/{core}/changes) | $0.01 per page, regardless of limit |
Costs are the same across all Cores (BiomedCore, TrialCore, etc.).
The change feed is priced per page rather than per item because it returns identifiers and change metadata, not record content — you still pay the normal per-record rate to fetch the records it points at. Scoping a page to a watchlist with amassId costs the same as an unscoped one.
Rate Limits
All plans include the following rate limits:
| Limit | Value |
|---|---|
| Requests per window | 60 |
| Window duration | 60 seconds |
| Scope | Per user + organization |
Rate limit headers are included on every response. See Overview for details.
For enterprise pricing or custom rate limits, contact us at support@amass.tech.
Credit Cost Header
Every billable response includes an X-Amass-Credit-Cost header indicating how many credits the request consumed. One credit is $0.01.
| Header | Example | Description |
|---|---|---|
X-Amass-Credit-Cost | 5 | Credits charged for this request |
Checking Remaining Credits
Use the credits endpoint to check how many API credits your organization has remaining.
GET /credits/api-creditsAccess: Organization admins only. Members will receive a 403 FORBIDDEN.
Response
{
"data": {
"remaining": 4250
}
}remaining is denominated in credits (1 credit = $0.01). This call does not consume credits.
Next Steps
- Authentication — Set up your API key
- Quickstart — Make your first API call