Skip to main content
The Nometria API lets you trigger deployments, check migration status, and manage your projects programmatically. Use it to integrate Nometria into your CI/CD pipeline or build internal tooling.

​
Base URL

https://api.nometria.com/v1

​
Authentication

All API requests require an API key passed in the Authorization header: 
Authorization: Bearer <your-api-key>
Get your API key: Dashboard → Settings → API Keys → New Key. API keys are scoped to your account and have access to all your projects. Treat them like passwords — never commit them to source code.
If an API key is compromised, revoke it immediately from Dashboard → Settings → API Keys.

​
Request format

All request bodies must be JSON with Content-Type: application/json. 
curl -X POST https://api.nometria.com/v1/deployments \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "proj_abc123"}'

​
Response format

All responses are JSON. Successful responses return a data object. Errors return an error object: 
// Success
{
  "data": {
    "id": "dep_xyz789",
    "status": "queued",
    "project_id": "proj_abc123"
  }
}

// Error
{
  "error": {
    "code": "not_found",
    "message": "Project proj_abc123 not found."
  }
}

​
HTTP status codes

CodeMeaning
200Success
201Created
400Bad request — check your request body
401Unauthorized — invalid or missing API key
403Forbidden — API key doesn’t have access to this resource
404Not found
429Rate limited — back off and retry
500Server error — contact support

​
Rate limits

TierRequests per minute
Free30
Pro120
Team600
Rate limit headers are included in every response: 
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1705000800

​
Pagination

List endpoints return paginated results using cursor-based pagination: 
{
  "data": [...],
  "pagination": {
    "has_more": true,
    "next_cursor": "cur_abc123"
  }
}
Pass cursor=cur_abc123 as a query parameter to get the next page.

​
SDKs

The Nometria API is a REST API — use it with any HTTP client. Node.js example: 
const response = await fetch('https://api.nometria.com/v1/projects', {
  headers: {
    'Authorization': `Bearer ${process.env.Nometria_API_KEY}`,
    'Content-Type': 'application/json'
  }
});
const { data } = await response.json();
Python example: 
import urllib.request
import json
import os

req = urllib.request.Request(
    'https://api.nometria.com/v1/projects',
    headers={
        'Authorization': f"Bearer {os.environ['Nometria_API_KEY']}",
        'Content-Type': 'application/json'
    }
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read())

​
API endpoints

Migrations

Create, list, and check the status of migrations

Deployments

Trigger, list, and rollback deployments