ESG

ESG Case

Get properties of an ESG case by its id

GET
https://api.textreveal.com/v3/esg/cases/{case_id}

Request

Parameters

  • case_id*uuid

    Unique identifier of the case.

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

    Fields to include in the response

    Values: "id", "categories", "entity_id", "dashboard_url", "last_activity", "score", "start_date", "sub_categories", "summary", "title", "related_events_count", "related_documents_count", "ungc_classification", "ungc_principles", "translated... 
  • translatelanguage-code (enum)

    In which language to translate the results.

    Default translated fields are: title, summary.

    If empty, translated_ fields won't be returned.

    Example: french

    Values: "af", "afr", "afrikaans", "albanian", "am", "amh", "amharic", "ar", "ara", "arabic", "armenian", "az", "aze", "azerbaijani", "ben", "bengali", "bg", "bn", "bos", "bosnian", "bs", "bul", "bulgarian", "ca", "cat", "catalan", "chinese"... 

Response

Response - 200

Properties of the case

  • iduuid

    Unique identifier of the case.

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

    List of categories assigned to the case.

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

    Permanent ID of the related entity.

    Example: "f337e172-528e-4808-b46e-be1ad6db7fbb"
  • dashboard_urluri | null

    Link to the case in SESAMm's Dashboard.

    Example: "https://dashboards.textreveal.com/case/5eb7182b-9b55-4f7a-b3e1-49062ee7cef9"
  • last_activitystring

    Last activity detected on the case. Corresponds to the date of the newest document associated to the case.

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

    Intensity score.

    Range: [1, 5]
  • start_datestring

    Case start date. Corresponds to the date of the oldest document associated to the case.

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

    List of sub-categories assigned to the case.

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

    Summary of the case.

    Example: "string"
  • titlestring

    Title of the case.

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

    Maximum UNGC classification of the events related to the case.

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

    List of UNGC principles of the events related to the case.

    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: Businesse... 
  • 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": "5eb7182b-9b55-4f7a-b3e1-49062ee7cef9",
  "categories": [
    "E"
  ],
  "entity_id": "f337e172-528e-4808-b46e-be1ad6db7fbb",
  "dashboard_url": "https://dashboards.textreveal.com/case/5eb7182b-9b55-4f7a-b3e1-49062ee7cef9",
  "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_events_count": 8,
  "related_documents_count": 43,
  "ungc_classification": "violator",
  "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."
  ],
  "translated_title": "string",
  "translated_summary": "string"
}

Error

Error - 400

Bad request

  • message*string

    Error message.

    Example: "The server returned an unexpected response"
  • code*integer

    Error code.

    Example: 400
  • reason*string (enum)

    Error reason.

    Values: "invalid", "timeout", "offline", "unknown", "not_found", "unauthorized", "forbidden", "internal", "too_many_requests"
  • errorsobject[]

    Possible error causes, like query params, headers or body.

Response
{
  "message": "The server returned an unexpected response",
  "code": 400,
  "reason": "invalid",
  "errors": [
    {
      "message": "Expected number, received string",
      "field": "size",
      "reason": "invalid_type"
    }
  ]
}

Error - 403

Not authorized

  • message*string
    Example: "Not authorized to access this resource"
  • code*number (enum)

    Error code.

    Values: 403
  • reason*string (enum)
    Values: "forbidden"
Response
{
  "message": "Not authorized to access this resource",
  "code": 403,
  "reason": "forbidden"
}

Error - 404

Not found

  • message*string
    Example: "[record] not found."
  • code*number (enum)

    Error code.

    Values: 404
  • reason*string (enum)
    Values: "not_found"
Response
{
  "message": "[record] not found.",
  "code": 404,
  "reason": "not_found"
}

Error - 429

Too many requests

  • message*string
    Example: "You have too many exports in progress."
  • code*number (enum)
    Values: 429
  • reason*string (enum)
    Values: "too_many_requests"
Response
{
  "message": "You have too many exports in progress.",
  "code": 429,
  "reason": "too_many_requests"
}