Overview
The Nomic API lets you upload files, parse documents, search an index of international codes and standards, and manage your organization programmatically. All endpoints are available under a single versioned base path.
Base URL
https://<your-domain>.nomic.ai/api/v0
Replace <your-domain> with your organization's Nomic domain.
Authentication
Authenticate every request with an API key in the Authorization header:
Authorization: Bearer npk_...
Create and manage API keys in the Developer Console at /developer on your Nomic instance. Each key is scoped to a specific user, and usage is attributed to that user's account.
Scopes
API keys are granted a set of scopes that control which endpoints they can access. When creating a key you choose which scopes to include.
Developer scopes
| Scope | Grants access to |
|---|---|
developer:files | Upload files |
developer:parse | Submit and poll parse jobs |
developer:agent | Search codes and standards |
Admin scopes
Admin scopes require the key's owner to be an organization admin.
| Scope | Grants access to |
|---|---|
admin:users:read | List and get user details |
admin:users:write | Disable and enable user accounts |
admin:api-keys:read | List API keys across the organization |
admin:api-keys:write | Revoke API keys |
admin:audit:read | Query audit logs |
Errors
All error responses return a JSON body with an error field:
{
"error": "File version not found"
}
Status codes
| Code | Meaning |
|---|---|
400 | Bad request — invalid or missing parameters |
401 | Missing or invalid API key |
403 | API key lacks the required scope |
404 | Resource not found or not accessible |
413 | Payload too large (file upload exceeds 500 MB) |
422 | Schema validation failed |
429 | Rate limit exceeded — see Rate limits |
500 | Internal server error |
501 | Feature unavailable on this instance |
503 | Dependent service not configured |
Pagination
List endpoints use cursor-based pagination. Pass limit to control page size and cursor to fetch the next page.
curl "https://<your-domain>.nomic.ai/api/v0/users?limit=25" \
-H "Authorization: Bearer $NOMIC_API_KEY"
The response includes:
| Field | Type | Description |
|---|---|---|
data | array | Items for the current page |
nextCursor | string or absent | Pass as cursor to fetch the next page. Absent when there are no more results. |
totalCount | number | Total matching items across all pages |
Stability
All v0 endpoints are currently experimental. Request and response shapes may change between releases. We recommend testing against your integration when upgrading.