Skip to main content

Base URL

https://api.transparencyhubnetwork.ai
For staging/testing:
https://testapp.transparencyhubnetwork.ai

Response Format

All API responses follow a consistent format:
{
  "status": "success",
  "data": { ... }
}
Error responses:
{
  "status": "error",
  "message": "Description of what went wrong"
}

HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request — invalid parameters
401Unauthorized — missing or invalid token
403Forbidden — insufficient permissions
404Not Found
500Internal Server Error

Pagination

List endpoints support pagination via query parameters:
ParameterTypeDefaultDescription
offsetinteger0Number of records to skip
limitinteger50Maximum records to return
Response includes pagination metadata:
{
  "data": [...],
  "pagination": {
    "total": 150,
    "offset": 0,
    "limit": 50
  }
}

Rate Limiting

API requests are rate-limited to 100 requests per minute per API key. Exceeding this limit returns a 429 Too Many Requests response.