Diligent ESG API
Official vendor OpenAPI document · agent-readyAnalyticsBusiness IntelligenceapiKey4 EndpointsREST
For Agents
List ESG metrics, retrieve sustainability reports, and submit new ESG data points to Diligent's corporate ESG platform. Useful for compliance, BI, and disclosure-automation agents.
Use for: List the ESG metrics tracked in our Diligent account, Retrieve the latest sustainability report from Diligent, Get the full content of a specific ESG report by its ID, Submit Scope 1 emissions data for Q2 to Diligent
Not supported: Does not handle board management, entity records, or audit workflows on the wider Diligent platform - use for ESG metric, report, and data-submission operations only.
The Diligent ESG API exposes environmental, social, and governance metrics, reports, and submission endpoints for corporate sustainability programmes. Sustainability and compliance teams can list defined ESG metrics, retrieve generated reports, fetch a specific report by ID, and submit new ESG data points for inclusion in upcoming filings. The four endpoints are designed to integrate Diligent's ESG platform with internal data warehouses, BI tools, and disclosure pipelines.
Install Jentic One Beta
Connect the Diligent ESG API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Diligent ESG API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdiligent.com%2Fdiligent" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdiligent.com%2Fdiligent" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Diligent ESG API.
List the catalog of defined ESG metrics tracked in the Diligent platform via /metrics
Retrieve all available ESG reports for the organization through /reports
Fetch a specific report by ID using /reports/{reportId}
Submit new ESG data points to the platform via POST /data/submit for inclusion in next reporting cycle
Use Cases
Patterns agents use Diligent ESG API for, with concrete tasks.
★ Automated ESG Data Ingestion from Internal Systems
Sustainability teams can pipe environmental and social metrics from internal systems (energy meters, HRIS, finance) directly into Diligent ESG by calling POST /data/submit on a schedule. This replaces manual spreadsheet uploads, reducing data lag and human error before disclosure deadlines such as CSRD, SEC climate, or TCFD. Most automated pipelines run nightly and process hundreds of metric points per submission.
POST to /data/submit with Scope 1 emissions readings for the last 24 hours and confirm the submission was accepted.
BI Dashboards for ESG Performance
Analytics teams can pull /metrics and /reports into BI tools such as Power BI, Tableau, or internal data lakes to visualise ESG performance alongside financial KPIs. The API delivers metric definitions and report payloads in a structured form that maps cleanly to dimensional models, enabling cross-functional dashboards for boards and executive committees.
List all ESG reports via /reports, then fetch /reports/{reportId} for the most recent quarterly report and load it into the BI staging table.
Disclosure-Ready Report Retrieval
Compliance and investor relations teams can retrieve fully generated ESG reports through /reports and /reports/{reportId} to drop into 10-K filings, sustainability reports, or investor decks. Pulling a stable, versioned report payload from Diligent removes the need to copy data between platforms and keeps numbers consistent across regulatory submissions and public communications.
Fetch the latest annual ESG report via /reports/{reportId} and extract the GHG emissions section for inclusion in the 10-K.
AI Agent ESG Compliance Assistant
AI agents can act as ESG compliance assistants - pulling metrics, checking which data points are missing for an upcoming reporting cycle, and submitting filled values when source data becomes available. Through Jentic the four Diligent operations are searchable as tools, and the API key is held in your Jentic One instance so the agent never sees the raw token.
Search Jentic for 'list ESG metrics from Diligent', load the /metrics operation, then chain a /data/submit call with the missing values once they are sourced.
Key Endpoints
4 endpoints — the diligent esg api exposes environmental, social, and governance metrics, reports, and submission endpoints for corporate sustainability programmes.
METHOD
PATH
DESCRIPTION
GET
/metrics
List defined ESG metrics
GET
/reports
List available ESG reports
GET
/reports/{reportId}
Retrieve a specific ESG report
POST
/data/submit
Submit new ESG data points
GET
/metrics
List defined ESG metrics
GET
/reports
List available ESG reports
GET
/reports/{reportId}
Retrieve a specific ESG report
POST
/data/submit
Submit new ESG data points
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Diligent ESG by hand means placing its API key in the request header and threading report ids through metric and submission calls yourself. Through Jentic you install once, import the Diligent ESG API from the API Directory, store the key once, and your agent calls it.
Permission scoping
The Diligent ESG surface is small, so scope your agent to the operations it needs, such as listing metrics or reading a report. You choose the operations it may call, so submitting a data point is not included unless you add it.
Credential isolation
Your Diligent ESG API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'list ESG metrics' or 'submit an ESG data point', and Jentic returns the matching Diligent operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Diligent ESG API through Jentic.
What authentication does the Diligent ESG API use?
It uses an API key passed via header (ApiKeyAuth security scheme). Keys are issued through your Diligent ESG tenant. Through Jentic, the key sits in your Jentic One instance and is injected when an agent executes a Diligent operation, so the agent never handles the raw key.
Can I submit new ESG data with the Diligent ESG API?
Yes, POST /data/submit accepts new ESG data points for inclusion in the next reporting cycle. Submissions reference metrics from /metrics so values land against the correct definition. Use this to automate pipelines from energy, finance, and HR systems.
What are the rate limits for the Diligent ESG API?
The OpenAPI spec does not publish explicit rate limits. As with most Diligent enterprise APIs, limits are tier-dependent and negotiated as part of the ESG platform contract. Contact your Diligent account team for your tenant's quota.
How do I retrieve a specific ESG report through Jentic?
Search Jentic for 'fetch ESG report from Diligent', load the schema for the /reports/{reportId} operation, and execute it with the report ID. Jentic returns the structured report payload, ready to feed into a BI tool or disclosure document.
Which ESG frameworks does the Diligent ESG API support?
The API exposes the metric catalog as configured in your Diligent ESG tenant; Diligent supports CSRD, GRI, SASB, TCFD, and SEC climate disclosures at the platform level. Use GET /metrics to see exactly which framework metrics are enabled for your organisation.
Can I limit what my agent is allowed to do with the Diligent ESG API?
Yes. Because your Jentic One instance is self-hosted, you decide which of the four Diligent ESG operations your agent may call and which credentials it may use. If the agent only needs to read data, you can grant just GET /metrics, GET /reports, and GET /reports/{reportId} while withholding POST /data/submit, so it can list metrics and pull reports without ever writing a new ESG data point. You expand that set only when you explicitly add an operation, and your stored API key is injected at execution time rather than exposed to the agent.
GET STARTED