Scope 3 Supplier Readiness API – Free ESG Data for Developers

Structured Scope 3 supplier readiness data for procurement platforms, ESG tools, and AI agents.

Query supplier readiness scores programmatically. Look up individual organisations, search by sector and region, or access aggregate statistics. Designed for integration into procurement workflows, ESG reporting tools, and AI-powered supply chain analysis.

Get Organisation Readiness

Look up a single organisation's Scope 3 Supplier Readiness score by slug.

Example Request

curl https://www.citableesg.com/api/v1/supplier-readiness/the-ethical-agency

Example Response

{
  "organisation": {
    "name": "The Ethical Agency",
    "slug": "the-ethical-agency",
    "country": "United Kingdom",
    "region": "europe",
    "isVerified": true,
    "profileUrl": "https://www.citableesg.com/org/the-ethical-agency"
  },
  "readiness": {
    "score": 79,
    "level": "ready",
    "label": "Scope 3 Ready",
    "passed": 11,
    "total": 14,
    "checks": [
      { "label": "Emissions data reported", "category": "emissions", "passed": true },
      { "label": "Third-party emissions assurance", "category": "emissions", "passed": true },
      { "label": "SBTi-aligned targets", "category": "emissions", "passed": false },
      ...
    ]
  },
  "lastUpdated": "2026-04-15T14:30:00.000Z"
}

Response Fields

Aggregate Readiness Statistics

Get platform-wide readiness statistics broken down by sector.

Example Response

{
  "totalOrganisations": 2450,
  "readyCount": 312,
  "partialCount": 890,
  "notReadyCount": 1248,
  "averageScore": 42,
  "bySector": {
    "manufacturing": { "count": 340, "readyCount": 67, "avgScore": 48 },
    "built_environment": { "count": 215, "readyCount": 41, "avgScore": 45 },
    ...
  }
}

Lookup by Domain

Resolve a vendor's email domain to a canonical Citable ESG Orgs. profile. Designed for procurement systems that want to validate a counterparty's ESG identity from their work-email address.

Example

curl "https://www.citableesg.com/api/v1/organisations/lookup?domain=patagonia.com"

Example Response

{
  "data": {
    "slug": "patagonia",
    "name": "Patagonia",
    "tagline": "We're in business to save our home planet.",
    "website": "https://www.patagonia.com",
    "country": "United States",
    "sectors": ["apparel", "outdoor_recreation"],
    "services": [],
    "sdgs": [12, 13, 14, 15],
    "isVerified": true,
    "profileCompleteness": 87,
    "profileUrl": "https://www.citableesg.com/org/patagonia",
    "schemaJsonLdUrl": "https://www.citableesg.com/api/v1/organisations/patagonia/schema.jsonld",
    "updatedAt": "2026-05-19T..."
  },
  "matchType": "exact",
  "query": { "domain": "patagonia.com" }
}

Matches use exact or suffixstrategy against the org's registered website host. Returns 404 if no claimed org matches the domain.

Canonical schema.org JSON-LD

The canonical Organization schema.org blob for an org, served as a standalone JSON-LD document. Procurement / reporting platforms and AI agents that consume structured data should call this endpoint directly rather than scraping the HTML profile page.

Example

curl https://www.citableesg.com/api/v1/organisations/patagonia/schema.jsonld

Response is content-typed application/ld+json (the canonical JSON-LD MIME). Cached 15 min at the edge. Fields included: name, url, sameAs, address, sectors, services, sdgs, credentials, memberships, climate targets. Page-only ornamentation (aggregate-rating, AI Citability Score) is intentionally dropped – fetch the HTML profile page for the full marketing view.

Error Responses

All errors return JSON: { "error": "description" }