Environment

Search owner entities owning one or more emission sources

Changed on

Search owner entities (companies, governments, operators) that own one or more sources in the inventory. Each returned id (E1... form) can be passed through /sources?owner_ids=... or /sources/emissions?owner_ids=... to restrict emission queries to that entity's assets. Data sourced from Climate TRACE under CC BY 4.0.

get/api/v1/environment/ct/owners

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/environment/ct/owners
  • Auth: API key in header x-api-key

Query parameters

namestring required

Name substring to match against owner legal / commercial names.

limitinteger

Maximum rows per page (1 to 1000).

offsetinteger

Offset into the matched result set.

Response

Matched owner entities with Climate TRACE identifiers usable as filters on emission queries.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes