Skip to main content
POST
Ownership, officers, beneficial owners and group of up to 20 companies.

Authorizations

Authorization
string
header
required

Org-scoped WorkOS API key (sk_...), sent as Authorization: Bearer <key>. Admins create and revoke keys in the Syrto dashboard: https://dashboard.syrto.ai/api-keys

Body

application/json
ids
string[]
required

1-20 references, each a companyId (Syrto id of one statement record, starts with Zm86) or a tax id (11-digit partita IVA or 16-character codice fiscale). A tax id resolves to the record selected by statementBasis. Duplicates are rejected.

Required array length: 1 - 20 elements
Required string length: 1 - 100
Example:
roleCategories
enum<string>[]

Return only officers holding a role in these categories.

Required array length: 1 - 9 elements
Available options:
GOVERNING_BODIES,
ADMINISTRATION_AND_EXECUTIVES,
AUDITING,
REPRESENTATION_AND_AUTHORITY,
EXTRAORDINARY_PROCEDURES,
FUNCTIONAL_ROLES,
PARTICIPATION_OWNERSHIP,
CHIEF_EXECUTIVE_OFFICER,
OTHER
language
enum<string>

Language of metric names, labels and descriptions (never of field names or slugs). Omitted: the account's default.

Available options:
it,
en

Response

Ownership, officers, beneficial owners and group of up to 20 companies.

data
object
required
meta
object
required