# 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[​](#fields "Direct link to Fields")

#### [`Identity.id`](#id) ● [`ID!`](https://docs.monei.com/apis/graphql/types/scalars/id/.md) non-null scalar[​](#id "Direct link to id")

Identity ID.

#### [`Identity.firstName`](#first-name) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#first-name "Direct link to first-name")

Representative's first name.

#### [`Identity.lastName`](#last-name) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#last-name "Direct link to last-name")

Representative's last name.

#### [`Identity.address`](#address) ● [`Address`](https://docs.monei.com/apis/graphql/types/objects/address/.md) object[​](#address "Direct link to address")

Representative's residential address.

#### [`Identity.email`](#email) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#email "Direct link to email")

Representative's email.

#### [`Identity.phone`](#phone) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#phone "Direct link to phone")

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

#### [`Identity.documentNumber`](#document-number) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#document-number "Direct link to document-number")

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

#### [`Identity.status`](#status) ● [`IdVerificationStatus`](https://docs.monei.com/apis/graphql/types/enums/id-verification-status/.md) enum[​](#status "Direct link to status")

Current state of the hosted ID-verification flow.

#### [`Identity.statusMessage`](#status-message) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#status-message "Direct link to status-message")

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

#### [`Identity.statusCode`](#status-code) ● [`Int`](https://docs.monei.com/apis/graphql/types/scalars/int/.md) scalar[​](#status-code "Direct link to status-code")

Provider-specific status code from the verification flow.

#### [`Identity.hasNoPublicActivity`](#has-no-public-activity) ● [`Boolean`](https://docs.monei.com/apis/graphql/types/scalars/boolean/.md) scalar[​](#has-no-public-activity "Direct link to has-no-public-activity")

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

#### [`Identity.nationality`](#nationality) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#nationality "Direct link to nationality")

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

#### [`Identity.citizenship`](#citizenship) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#citizenship "Direct link to citizenship")

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

### Returned By[​](#returned-by "Direct link to Returned By")

[`updateIdentity`](https://docs.monei.com/apis/graphql/operations/mutations/update-identity/.md) mutation