ESG

ESG Event

Get one event

GET
https://api.textreveal.com/v3/esg/events/{event_id}

Request

Parameters

  • event_id*uuid

    Unique identifier of the event

  • fields(string (enum))[]

    Fields to include in the response

    Default: ["id", "case_id", "categories", "entity_id", "dashboard_url", "last_activity", "score", "start_date", "sub_categories", "summary", "title", "related_documents_count", "translated_title", "translated_summary"]Values: "id", "case_id", "categories", "entity_id", "dashboard_url", "last_activity", "score", "start_date", "sub_categories", "summary", "title", "related_documents_count", "ungc_classification", "ungc_principles", "ungc_explanation", "translated_title", "translated_summary"
  • translatelanguage-code

    In which language to translate the results.

    Default translated fields are: title, summary.

    If empty, translated_ fields won't be returned.

    Example: french

Response

Response - 200

Properties of the event

  • iduuid

    Unique identifier of the event.

    Example: "e7c2464e-0dc8-441a-970b-0d23eeabe3d1"
  • case_iduuid

    ID of the case associated with the event.

    Example: "5eb7182b-9b55-4f7a-b3e1-49062ee7cef9"
  • categories(string (enum))[]

    List of categories assigned to the event.

    Values: "E", "S", "G"
  • entity_iduuid

    Permanent ID of the related entity.

  • dashboard_urluri

    Link to the event in SESAMm's Dashboard.

    Example: "https://dashboards.textreveal.com/event/e7c2464e-0dc8-441a-970b-0d23eeabe3d1"
  • last_activitydate-time

    Last activity detected on the event. Correspond to the date of the newest document associated to the event.

    Example: "2025-11-07T08:35:37.658Z"
  • scoreinteger

    Intensity score.

    Range: [1, 5]
  • start_datedate-time

    Event start date. Corresponds to the date of the oldest document associated to the event.

    Example: "2025-10-06T04:55:21.713Z"
  • sub_categoriesstring[]

    List of sub-categories assigned to the event.

    Example: ["Climate Change"]
  • summarystring | null

    Summary of the event.

    Example: "string"
  • titlestring

    Title of the event.

    Example: "string"
  • ungc_classificationstring | null (enum)

    UNGC classification of the event.

    Values: "violator", "watchlist", "low risk"
  • ungc_principles(string (enum))[]

    List of UNGC principles related to the event. Always null when classification is low risk.

    Values: "Principle 1: Businesses should support and respect the protection of internationally proclaimed human rights.", "Principle 2: Businesses should make sure that they are not complicit in human rights abuses.", "Principle 3: Businesses should uphold the freedom of association and the effective recognition of the right to collective bargaining.", "Principle 4: Businesses should uphold the elimination of all forms of forced and compulsory labour.", "Principle 5: Businesses should uphold the effective abolition of child labour.", "Principle 6: Businesses should uphold the elimination of discrimination in respect of employment and occupation.", "Principle 7: Businesses should support a precautionary approach to environmental challenges.", "Principle 8: Businesses should undertake initiatives to promote greater environmental responsibility.", "Principle 9: Businesses should encourage the development and diffusion of environmentally friendly technologies.", "Principle 10: Businesses should work against corruption in all its forms, including extortion and bribery."
  • ungc_explanationstring | null

    Explanation of the UNGC classification of the event.

    Example: "string"
  • translated_titlestring | null

    Translated version of title field. See translate query parameter.

    Example: "string"
  • translated_summarystring | null

    Translated version of summary field. See translate query parameter.

    Example: "string"
Response
{
  "id": "e7c2464e-0dc8-441a-970b-0d23eeabe3d1",
  "case_id": "5eb7182b-9b55-4f7a-b3e1-49062ee7cef9",
  "categories": [
    "E"
  ],
  "entity_id": "00000000-0000-0000-0000-000000000000",
  "dashboard_url": "https://dashboards.textreveal.com/event/e7c2464e-0dc8-441a-970b-0d23eeabe3d1",
  "last_activity": "2025-11-07T08:35:37.658Z",
  "score": 2,
  "start_date": "2025-10-06T04:55:21.713Z",
  "sub_categories": [
    "Climate Change",
    "Water Pollution"
  ],
  "summary": "string",
  "title": "string",
  "related_documents_count": 43,
  "ungc_classification": "string",
  "ungc_principles": [
    "Principle 1: Businesses should support and respect the protection of internationally proclaimed human rights.",
    "Principle 2: Businesses should make sure that they are not complicit in human rights abuses."
  ],
  "ungc_explanation": "string",
  "translated_title": "string",
  "translated_summary": "string"
}