API Documentation

Integrate Emisthra with your existing systems using our comprehensive REST API

Quick Start

Authentication

# Get your API token
curl -X POST https://api.emisthra.com/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "username": "your-email@example.com",
    "password": "your-password"
  }'

# Use the token in subsequent requests
curl -X GET https://api.emisthra.com/api/data-collect/facilities \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

API Endpoints

Authentication

POST/api/auth/token

GET/api/auth/users/me

Get current user information

POST/api/auth/token/refresh

Refresh access token

Data Collection

GET/api/data-collect/facilities

List all facilities

POST/api/data-collect/facilities

Create a new facility

GET/api/data-collect/submissions

List submissions

POST/api/data-collect/submissions

Create a new submission

CBAM Reporting

GET/api/cbam-reporting/declarations

List CBAM declarations

POST/api/cbam-reporting/declarations

Create a declaration

GET/api/cbam-reporting/export/xml

Export declaration as XML

Analytics

GET/api/analytics/dashboard/organization

Organization dashboard data

GET/api/analytics/dashboard/supplier

Supplier dashboard data

GET/api/analytics/trends/organization

Emission trends

Emission Factors

GET/api/emission-factors

List emission factors

POST/api/emission-factors

Create emission factor

GET/api/emission-factors/{id}

Get emission factor details

Carbon Pricing

GET/api/carbon-pricing/current

Get current carbon price

GET/api/carbon-pricing/history

Get price history

GET/api/carbon-pricing/calculate

Calculate CBAM cost

API Features

OpenAPI Documentation

Complete API documentation with interactive Swagger UI for testing endpoints.

OAuth 2.0 Authentication

Secure authentication using industry-standard OAuth 2.0 with JWT tokens.

Webhook Support

Real-time notifications via webhooks for submission status changes and events.

Integration Resources

Base URL

https://api.emisthra.com

Interactive API Docs

Visit /docs endpoint for Swagger UI

Admin Portal

Access the full admin UI at Admin Portal

Need Help with Integration?

Our developer support team is here to help you integrate Emisthra into your systems.

Contact Developer Support