Entities
ESG

Entities CES Stats

Get Aggregated CES Data for one entity

GET
https://api.textreveal.com/v3/entities/{entity_id}/esg/ces/stats

Request

Parameters

  • entity_id*uuid

    Unique identifier of the entity

  • sizeinteger

    Number of records per page

    Default: 10Range: [1, 1000]
  • search_afterstring

    search_after field value from the previous page

  • datedate (operator)

    The date at which the ces score was calculated.

    Example: "between:2022-01-01;2022-01-02"
  • orderfield:direction

    Order to apply to the result.

    Possible fields are: date, value.

    Possible directions are: asc and desc.

    Default: date:ascExample: "date:asc"
  • functionstring (enum)

    Function to apply to the result.

    Default: "first"Values: "min", "max", "first", "last", "avg"
  • periodstring (enum)

    Period to apply the function to.

    Example: with period=quarterly and function=first, the result will contain each quarter's first ces value per entity.

    Default: "all"Values: "all", "day", "week", "month", "quarter", "year"

Response

Response - 200

Aggregated CES Scores

  • data*object[]

    Paginated Entities CES list.

  • size*integer

    Number of records per page requested.

    Example: 1
  • has_next*boolean

    True if there are more records available.

    Example: true
  • count*integer

    Number of records returned in the current page.

    Example: 1
  • search_after*string | null

    Cursor for next page.

Response
{
  "data": [
    {
      "entity_id": "00000000-0000-0000-0000-000000000000",
      "period_start_date": "2025-05-06",
      "period_end_date": "2025-05-13",
      "value": 50
    }
  ],
  "size": 1,
  "has_next": true,
  "count": 1,
  "search_after": "string"
}