UBOs

Ultimate Beneficial Owner (UBO) of a legal entity. Represents a natural person who
ultimately owns or controls the company, as required by AML regulations.

Fields

Fields on the Ubo object.

Field	Type	Description
`id`	`ID!`	—
`status`	`UboStatus!`	—
`controlType`	`UboControlType!`	—
`ownershipPercentage`	`Float!`	Percentage of ownership held by this UBO.
`firstName`	`String!`	—
`lastName`	`String!`	—
`birthPlace`	`String!`	—
`birthDate`	`Time!`	—
`postalCode`	`String!`	—
`addressLine1`	`String!`	—
`addressLine2`	`String`	—
`city`	`String!`	—
`email`	`String!`	—
`phoneNumber`	`String!`	—
`gender`	`UboGender!`	—
`nationality`	`Country!`	Country of nationality.
`birthplaceCountry`	`Country`	Country of birth.
`country`	`Country!`	Country of residence.
`uboDeclaration`	`UboDeclaration!`	Parent UBO declaration this UBO belongs to.
`documents`	`DocumentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of identity documents submitted for this UBO.
`requirements`	`UboRequirements!`	Document categories still required for compliance.
`comments`	`CommentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of review comments on this UBO.

Queries

Root queries that return or operate on this object.

`ubo`

Retrieve a single UBO by its ID.

type Query {
  ubo(id: ID!): Ubo!
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

Ubo

`uboDeclaration`

Retrieve a single UBO declaration by its ID.

type Query {
  uboDeclaration(id: ID!): UboDeclaration!
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

UboDeclaration

Related types

Supporting objects, inputs, and enums used by this page.

Objects

`UboConnection`

Type: object

Relay connection for paginated Ubo results.

Fields

Field	Type	Description
`nodes`	`[Ubo]!`	—
`edges`	`[UboEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UboDeclaration`

Type: object

Declaration grouping one or more UBOs for a legal entity, subject to compliance approval.

Implements: Node, AlertReference

Fields

Field	Type	Description
`id`	`ID!`	—
`status`	`UboDeclarationStatus!`	—
`alert`	`Alert`	Active compliance alert linked to this declaration, if any.
`ubos`	`UboConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of UBOs included in this declaration.
`comments`	`CommentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of review comments on this declaration.

`UboEdge`

Type: object

Relay edge wrapping a Ubo node with its pagination cursor.

Fields

Field	Type	Description
`cursor`	`String!`	—
`node`	`Ubo!`	—

`UboRequirements`

Type: object

Set of document categories required for a UBO to pass compliance review.

Fields

Field	Type	Description
`documentCategories`	`[DocumentCategoryUbo!]!`	—

Enums

`UboControlType`

Type: enum

Type of control the UBO exercises over the legal entity.

Values

Value	Description
`DIRECT_OWNERSHIP`	Direct shareholding in the company.
`INDIRECT_HOLDING`	Indirect holding through one or more intermediaries.
`EXERCISE_OF_OTHER_CONTROL_POWER`	Exercise of control through other means such as voting agreements.
`LEGAL_REPRESENTATIVE`	Legal representative of the entity.

`UboDeclarationStatus`

Type: enum

Approval workflow status of a UBO declaration.

Values

Value	Description
`WAITING_FOR_APPROVAL`	Declaration has been submitted and awaits compliance approval.
`APPROVED`	Declaration has been approved.
`REJECTED`	Declaration has been rejected.
`CREATED`	Declaration has been created but not yet submitted.

`UboGender`

Type: enum

Gender of the UBO.

Values

Value	Description
`MALE`
`FEMALE`
`OTHER`

`UboStatus`

Type: enum

Review status of an Ultimate Beneficial Owner record.

Values

Value	Description
`PENDING`	UBO record awaits compliance review.
`REFUSED`	UBO record was rejected during compliance review.
`CANCELLED`	UBO record was cancelled.
`VALIDATED`	UBO record passed compliance review.