Universes CES
Get CES for all entities of one universe
The CES is only available 48 hours after an entity is registered. Before that, the route returns the universe CES without including newly registered entities.
Request
Parameters
universe_id*uuidUnique identifier of the universe.
Example: "75ebc096-749e-4b8f-b690-df13daf49c62"sizeintegerNumber of records per page
Default: 10Range: [1, 10000]search_afterstringsearch_afterfield value from the previous pagerevenue(integer (operator))[]Revenue history of this company. Searches on the
Example: "gte:1000000"valuefield.unspsc(string (operator))[]United Nations Standard Products and Services Codes for the entity. Searches on entity code values.
Example: "eq:51000000"sector(string (operator))[]ISIC4 section code, a single letter from A to U, as returned by the
/isicroute.You can input a section code or use the following operators: eq (=), neq (≠), in, nin (not in)
Example:
Example: "eq:hello"eq:Cfor Manufacturing,in:C;Jto filter on several sectionsemployee_count(integer (operator))[]Number of employees of this company.
Example: "gte:1000"datedate (operator)Extraction date
Example: "between:2022-01-01;2022-01-02"order(field:direction (enum))[]Order to apply to the result.
Possible fields are:
date,ces_score.Possible directions are:
ascanddesc.You can specify multiples values.
Default: [date:asc, ces_score:desc]Example: "date:asc"pageintegerPage number, 1-based
Minimum: 1
Response
CES Scores
data*object[]Paginated Entities CES list with composed cursor.
Array length: [0, ∞]size*integerNumber of records per page requested.
Minimum: 1has_next*booleanTrue if there are more records available.
Example: truecount*integerNumber of records returned in the current page.
Minimum: 0search_after*string | nullCursor for next page.
total*integerTotal number of records.
Minimum: 0
{
"data": [
{
"entity_id": "00000000-0000-0000-0000-000000000000",
"date": "2025-05-06",
"ces_score": 89
}
],
"size": 1,
"has_next": true,
"count": 1,
"search_after": "string",
"total": 1
}Error
Bad request
message*stringError message.
Example: "Check the errors field for more details"code*number (enum)Error code.
Values: 400reason*string (enum)Error reason.
Values: "invalid"errorsobject[]Possible error causes.
Array length: [1, ∞]
{
"message": "Check the errors field for more details",
"code": 400,
"reason": "invalid",
"errors": [
{
"message": "string",
"field": "size",
"reason": "invalid_type"
}
]
}Unauthorized
message*stringError message.
Example: "Authorization header is expected"code*number (enum)Error code.
Values: 401reason*string (enum)Error reason.
Values: "unauthorized"errors*object[]Array length: [1, 1]
{
"message": "Authorization header is expected",
"code": 401,
"reason": "unauthorized",
"errors": [
{
"message": "Required",
"field": "headers.authorization",
"reason": "invalid_type"
}
]
}Payment required
message*stringError message.
Example: "Your account does not have access to this entity. Contact SESAMm sales for more information."code*number (enum)Error code.
Values: 402reason*string (enum)Error reason.
Values: "forbidden"
{
"message": "Your account does not have access to this entity. Contact SESAMm sales for more information.",
"code": 402,
"reason": "forbidden"
}Forbidden
message*stringError message.
Example: "Missing required permissions to perform this action."code*number (enum)Error code.
Values: 403reason*string (enum)Error reason.
Values: "forbidden"
{
"message": "Missing required permissions to perform this action.",
"code": 403,
"reason": "forbidden"
}Not found
message*stringError message.
Example: "The requested universe does not exist or is not visible to your organization."code*number (enum)Error code.
Values: 404reason*string (enum)Error reason.
Values: "not_found"
{
"message": "The requested universe does not exist or is not visible to your organization.",
"code": 404,
"reason": "not_found"
}Generic errors are not shown, see Errors for more details.