Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ESG Rating Data, 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.
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%2Fesgenterprise.com%2Fesgenterprise" | shStep 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%2Fesgenterprise.com%2Fesgenterprise" | 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.
What an agent can do with ESG Rating Data API.
Search ESG ratings for a company by name and retrieve its sector, score, and breakdown
Screen suppliers or portfolio holdings against ESG performance thresholds
Pull batch ESG ratings for a list of investee or vendor companies
Append ESG context to internal company records during procurement reviews
Filter companies by sector to compare ESG performance within an industry
GET STARTED
Patterns agents use ESG Rating Data API for, with concrete tasks.
★ Supplier ESG screening during procurement
Procurement teams query the search endpoint with each supplier name before signing a contract, retrieving the company's ESG rating and sector classification. Suppliers below an internal threshold are flagged for human review or excluded entirely from preferred-vendor lists. This automates a control that otherwise relies on manual rating database lookups.
For each supplier name in the procurement queue, call GET /search with the name as a query parameter and reject any supplier whose rating falls below the BBB threshold.
ESG-aware portfolio screening for an investment fund
Analysts at a sustainable investment fund call the rating data endpoint for every ticker in their universe and persist the score alongside their existing factor data. The fund then excludes holdings below a cut-off and rebalances toward higher-rated names. The single-endpoint design makes it easy to schedule a daily refresh.
Pull ESG ratings for the 500 companies in the model portfolio via /search and exclude any whose score is below 50.
Sustainability research and benchmarking
ESG researchers comparing companies within a sector pull ratings for a set of competitors and benchmark each against the sector average. Because the response includes sector tagging, the same query can be reused to assemble peer groups without separate classification calls. The output drives published research notes and internal sustainability reports.
Search ratings for the top 10 oil and gas majors and compute the sector average ESG score, flagging companies more than 10 points below the mean.
AI agent enriching CRM records with ESG context
An AI agent connected to a CRM iterates through account records, calls the ESG rating search for each company name through Jentic, and writes the score into a custom field. Sales reps then prioritise outreach to ESG-aligned accounts, and the field is refreshed monthly. Through Jentic, the API token never enters the agent's context.
For each account in the 'Strategic' segment, search ESG ratings via Jentic and patch the account's 'esg_score' field with the returned value.
1 endpoints — jentic publishes the only available openapi specification for esg rating data, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/search
Search ESG ratings for companies by name
/search
Search ESG ratings for companies by name
What agents get from Jentic-routed access to this vendor.
Setup
Wiring ESG Rating Data by hand means passing your key as the 'token' query parameter, targeting the us-east-1 API Gateway host, and shaping the company-name search yourself. Through Jentic you install once, import ESG Rating Data from the API Directory, store the api_key once, and your agent calls it.
Permission scoping
ESG Rating Data exposes a single read-only search operation with the company name in the query string, so scope the agent to that lookup operation. You choose which operations are allowed, so nothing beyond the ESG rating search runs unless you add it.
Credential isolation
Your ESG Enterprise api_key is stored once, encrypted, by your own Jentic One instance and injected as the token query parameter at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'look up an ESG rating for a company', and Jentic returns the GET /search operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using ESG Rating Data API through Jentic.
Why is there no official OpenAPI spec for ESG Rating Data?
ESG Enterprise does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call ESG Rating Data via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the ESG Rating Data API use?
The API uses an api_key passed as a query parameter named 'token'. Through Jentic, the token is held in the vault and supplied at execution time, so the agent never sees the raw value.
Can I retrieve ESG ratings for private companies with this API?
The /search endpoint accepts any company name, but coverage is strongest for publicly listed issuers and large privately held firms; smaller private companies may return empty results. Always check for an empty response and fall back to a different data source when no rating is available.
What are the rate limits for the ESG Rating Data API?
ESG Enterprise does not publish explicit rate limits in the spec. Treat batch screening jobs conservatively, paginate or sleep between requests, and back off on any HTTP 429 or 5xx response.
How do I screen a list of suppliers with this API through Jentic?
Use the Jentic search query 'look up ESG rating for a company'. Jentic returns the GET /search operation, load the schema, and execute it once per supplier name. The agent collects the returned score and sector and applies your screening rule without ever handling the API token.
Does the response include the underlying ESG score components?
The search response includes the overall ESG rating and sector classification but does not break out the individual environmental, social, and governance pillar sub-scores. For the full breakdown you need to subscribe to ESG Enterprise's premium data product, which is not exposed via this public spec.
Can I limit what my agent is allowed to do with the ESG Rating Data API?
Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, and this API exposes only a single read-only GET /search operation that looks up ESG ratings by company name. Scope the agent to that one search operation so it can retrieve a company's score and sector but nothing else. Your ESG Enterprise api_key stays with your instance and is injected as the token query parameter at execution time, so the agent never handles the raw key.
Know of an official OpenAPI document? Contribute it →
For Agents
Look up ESG (environmental, social, governance) ratings for companies by name to inform sustainability and supplier-risk decisions.
Use for: I need to look up the ESG rating for a public company, Find all companies in the energy sector with their ESG scores, Retrieve the sustainability rating for a supplier I am about to onboard, Get the ESG breakdown for a portfolio of 50 holdings
Not supported: Does not handle financial fundamentals, credit ratings, or news sentiment - use for ESG rating lookups by company name only.
Jentic publishes the only available OpenAPI specification for ESG Rating Data, keeping it validated and agent-ready. ESG Enterprise's Rating Data API exposes a single search endpoint that returns environmental, social, and governance scores for publicly listed and private companies. Each result includes the company identifier, sector classification, and the rating breakdown used for sustainability research, supplier due diligence, and ESG-aware portfolio screening. Authentication is by query token, making it easy to drop into a spreadsheet pull or a research notebook.