Live

API access

We're building enterprise API access for developers and organizations who need programmatic carbon analysis. The documentation below shows what will be available. Interested in early access?

Request early access Join waitlist

NusaCarbon API

RESTful API for digital MRV and carbon estimation

Preview

Base URL

https://api.nusacarbon.com

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Your API keys

API Endpoints

GET/v1/public/whoami

Who this key belongs to, its tier, and how much quota is left

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/whoami   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/projects

Your projects, newest first. Accepts ?limit=1..200

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/projects   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/projects/:id

One project with its polygon, area, and provenance notes

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/projects/PROJECT_ID   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/reports

Your reports with their content hashes, without the file bytes

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/reports   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/verify/:hash

Check a report hash. Works for reports you do not own

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/verify/CONTENT_HASH   -H "Authorization: Bearer $NUSACARBON_API_KEY"

Model Context Protocol

Read only tools for an AI assistant, using your own key

Five tools, all read only. Nothing here can change your data. Payloads are trimmed so a tool call does not burn the caller's context, and anything derived from a fixed threshold or the 2021 land cover prior says so inside the payload rather than only in this page.

1. Download the server

curl -O https://www.nusacarbon.com/nusacarbon-mcp.mjs

2. Create a key above, then point your client at the file

{
  "mcpServers": {
    "nusacarbon": {
      "command": "node",
      "args": ["/full/path/to/nusacarbon-mcp.mjs"],
      "env": { "NUSACARBON_API_KEY": "your key here" }
    }
  }
}

nusacarbon_whoami
nusacarbon_list_projects
nusacarbon_get_project
nusacarbon_list_reports
nusacarbon_verify_report

Rate Limits

Student300 requests/hour

Faculty600 requests/hour

Commercial1000 requests/hour

Counted per key per hour in the database, not in process memory, so the limit is the same on every server. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset, not only the rejections. When the hour is exhausted the answer is 429 with Retry-After.

API Endpoints

GET/v1/public/whoami

Who this key belongs to, its tier, and how much quota is left

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/whoami   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/projects

Your projects, newest first. Accepts ?limit=1..200

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/projects   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/projects/:id

One project with its polygon, area, and provenance notes

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/projects/PROJECT_ID   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/reports

Your reports with their content hashes, without the file bytes

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/reports   -H "Authorization: Bearer $NUSACARBON_API_KEY"

GET/v1/public/verify/:hash

Check a report hash. Works for reports you do not own

any

Example Request

curl -s https://api.nusacarbon.com/v1/public/verify/CONTENT_HASH   -H "Authorization: Bearer $NUSACARBON_API_KEY"