API Reference

The Grantiva API is organized around REST. All requests and responses use JSON. The base URL is:

https://api.grantiva.io/api/v1/

Health check

curl https://api.grantiva.io/health

{
  "status": "healthy",
  "timestamp": "2025-03-10T12:00:00Z"
}

All errors return a consistent format:

{
  "error": "not_found",
  "message": "Resource not found"
}

Status	Description
`400`	Bad request — invalid input
`401`	Unauthorized — missing or invalid authentication
`403`	Forbidden — insufficient permissions or inactive tenant
`404`	Not found
`409`	Conflict — duplicate resource
`429`	Rate limited
`500`	Server error

Rate limits vary by plan. When exceeded, the API returns 429 Too Many Requests. Retry after the delay indicated in the response.

List endpoints support pagination:

?page=1&per=20

Responses include metadata:

{
  "items": [...],
  "metadata": {
    "page": 1,
    "per": 20,
    "total": 142
  }
}