Identity

Account representative undergoing KYC/identity verification. Stores personal data, document number, and the verification outcome produced by the hosted ID-verification session (see createIdSession).

type Identity {
  id: ID!
  firstName: String
  lastName: String
  address: Address
  email: String
  phone: String
  documentNumber: String
  status: IdVerificationStatus
  statusMessage: String
  statusCode: Int
  hasNoPublicActivity: Boolean
  nationality: String
  citizenship: String
}

Fields

Identity.id ● ID! non-null scalar

Identity ID.

Identity.firstName ● String scalar

Representative's first name.

Identity.lastName ● String scalar

Representative's last name.

Identity.address ● Address object

Representative's residential address.

Identity.email ● String scalar

Representative's email.

Identity.phone ● String scalar

Representative's phone in E.164 format, e.g. +34666777888.

Identity.documentNumber ● String scalar

Tax/identity document number (e.g. NIF/CIF/NIE for Spain, passport number for non-EU residents).

Identity.status ● IdVerificationStatus enum

Current state of the hosted ID-verification flow.

Identity.statusMessage ● String scalar

Human-readable status detail (e.g. provider rejection reason).

Identity.statusCode ● Int scalar

Provider-specific status code from the verification flow.

Identity.hasNoPublicActivity ● Boolean scalar

Representative self-declares no PEP/public-activity exposure. Required by AML rules in simplified onboarding.

Identity.nationality ● String scalar

Country of nationality (ISO 3166-1 alpha-2). Country of origin/birth; may differ from citizenship for dual citizens or naturalized citizens.

Identity.citizenship ● String scalar

Country of legal citizenship (ISO 3166-1 alpha-2). May differ from nationality for dual citizens or naturalized citizens.

Returned By

updateIdentity mutation