Skip to main content

API Reference

The Tellus EHS platform exposes a RESTful API for all operations.

API Documentation​

Interactive API documentation is available at:

  • Swagger UI: {API_URL}/api/docs
  • ReDoc: {API_URL}/api/redoc

Authentication​

All API requests require authentication via JWT tokens obtained from Supabase Auth.

curl -H "Authorization: Bearer <token>" \
  https://api.tellus-ehs.com/api/v1/chemicals

Base URL​

  • Development: http://localhost:8000/api/v1
  • Production: https://api.tellus-ehs.com/api/v1

Core Endpoints​

ChemIQ​

  • GET /chemicals - List chemicals
  • POST /chemicals - Create chemical
  • GET /chemicals/{id} - Get chemical details
  • GET /sds - List SDS documents
  • POST /sds/upload - Upload SDS

AdminHQ​

  • GET /companies - Company details
  • GET /sites - List sites
  • GET /users - List users
  • POST /users/invite - Invite user

Error Handling​

All errors follow a consistent format:

{
  "success": false,
  "message": "Error description",
  "error": "ERROR_CODE"
}