# How identities, addresses, and verifications work

In countries with [regulatory requirements](https://www.didww.com/resources/regulatory-requirements), some services need
valid information about the end user of a number. The **Identities & Addresses** section stores this information as
reusable records. You create an identity and its address once, then submit them for the services that require them.

## How they fit together

- **Identities** and **addresses** are reusable records of the end user. Every service that needs end-user details uses the same records: DID number registration, Porting, Sender ID Verifications and Emergency Calling use an identity and an address. CNAM OUT uses an identity only.
- **Verifications** track DID number registration only. A verification request submits an identity and address for DID numbers that require registration.

```
        %%{init: {
  "theme": "base",
  "themeVariables": {
    "fontSize": "14px",
    "primaryColor": "#e0f2fe",
    "primaryBorderColor": "#38bdf8",
    "primaryTextColor": "#1f2d3d",
    "lineColor": "#0f766e"
  }
}}%%

flowchart LR
   identity[Identity] --> address[Address]
   address --> verif[Verification request] --> reg[DID number registration]
   address ---> port[Number Porting]
   address ---> sid[Sender ID Verifications]
   address ---> emer[Emergency Calling]
   identity ----> cnam[CNAM OUT]
```

Each service submits the records in its own request:

| Service | How it uses identity and address records |
| --- | --- |
| DID number registration | Registers the end user of a DID number in countries where registration is required. Submit the records during checkout or later from **Phone Numbers > My Numbers**. This is the only service tracked in **Identities & Addresses > Verifications**. |
| Porting | Provides the end-user details for a porting request that moves numbers from another provider to DIDWW. See [Create a porting request](../phone-numbers/number-porting/porting-requests/create-porting-request.html). |
| Sender ID Verifications | Registers a Sender ID for A2P messaging. Only a **Business** identity can be used. See [How Sender ID verification works](../sms/sender-id-verifications/how-sender-id-verification-works.html). |
| Emergency Calling | Records the end user and the emergency service address of an Emergency Calling Service. See [How Emergency Calling works](../voice/emergency-calling/how-emergency-calling-service-works.html). |
| CNAM OUT | Uses an identity only, no address. Registers the caller name of US DID numbers. You select the identity when you configure CNAM OUT. See [Manage CNAM OUT](../phone-numbers/my-numbers/how-to-guides/configure-cnam-out.html#user-panel-cnam-out). |

## Identities

An identity is the person or business that is the end user of a service. It holds the personal or company details,
proofs of identity and supporting documents. An identity can have one or more addresses.

### Personal and Business identities

- **Personal**: an individual. First name, last name and phone number are always required.
- **Business**: a company. The company name and the first name, last name and phone number of the company representative are always required.

The requirement for the country, number type and service decides which identity types are accepted and which other
fields and documents are needed. For example, Sender ID Verifications accept only Business identities. For the fields of
each type, see the [Identities reference](identities.html#user-panel-identities).

### Main account identity

Your **main account identity** is the identity of your DIDWW account. It holds the details shown in **Account Settings >
Account Details > Account Identity & Address**. It is created when you complete the **Account Details** step of [Account
setup](../account-settings/account-setup.html#user-panel-account-verification).

In the **Identities** list, an icon next to the name marks it. Hover over the icon to see **Your main account
identity.** The main account identity cannot be deleted.

The **Identity Verification** step of Account setup confirms that you own the DIDWW account. It does not create a
verification request for any number, and it does not approve your identities or addresses for regulated services.

### Reusing identities

You can reuse an identity for several numbers and services. After a request that uses it is approved, an identity may be
reused for numbers with the same level of restrictions, as long as it still meets the applicable requirement.

A number that is already linked to an identity, for example through registration, Sender ID Verifications or CNAM OUT,
can be used for other services only with that same identity. Once an identity is used to activate a service for a
number, use it for later service activations of the same number too.

### Identity hierarchy

When a number is linked to identities through more than one service, the identity hierarchy decides which one takes
precedence. The priority is ranked from highest (1) to lowest (3):

1. Number Registration identity
2. Sender ID Verification identity, Emergency Calling identity, CNAM OUT identity
3. Porting identity

The assigned identity for a number is shown in the [Identity
column](../phone-numbers/my-numbers/my-numbers-reference.html#my-numbers-reference-end-user-details) of **Phone Numbers
> My Numbers**.

Note

If a number registration is pending, its identity cannot be assigned to other services (Sender ID Verifications,
Emergency Calling, CNAM OUT) until the registration is approved.

## Addresses

An address is a physical address that belongs to an identity, with proofs of address. You can create it together with a
new identity, or add it later to an existing identity. See [Add new address to
identity](how-to-guides/add-new-address-to-identity.html#create-new-address).

The requirement can restrict where the address must be, for example in the country of the number or in the area of its
area code. For the fields, see the [Addresses reference](addresses.html#user-panel-addresses).

Like identities, addresses are reusable. After a request that uses it is approved, an address may be reused for numbers
with the same level of restrictions, as long as it still meets the applicable requirement.

Your **main account address** is the address of your DIDWW account, shown in **Account Settings > Account Details >
Account Identity & Address**. In the **Addresses** list, an icon marks it. Hover over the icon to see **Your main
account address.** The main account address cannot be deleted.

## Verifications

The **Verifications** tab tracks DID number registration only. Porting requests, Sender ID Verifications and Emergency
Calling Services are tracked in their own sections.

A verification request is created each time you assign an identity and address to DID numbers that require registration,
during checkout or from **Phone Numbers > My Numbers**. The DIDWW Compliance Team reviews the request. It can be
**Pending**, **Approved** or **Rejected**. See [How DID number verification
works](verifications/how-did-number-verification-works.html#user-panel-how-did-verification-works) and the
[Verifications reference](verifications/verifications-reference.html#user-panel-verifications-reference).

A saved identity or address is not approved by itself, and neither is a **Valid** result in the **Requirements** panel.
The records are approved for a number only when its verification request is approved.

Editing an identity or address does not resubmit a rejected request. After you correct the records, [resubmit the
request](verifications/how-to-guides/resubmit-rejected-end-user-details.html#re-submit-end-user-details). Resubmitting
creates a new verification request with a new reference ID.

### Demo numbers

In some countries, the requirement text says that the number provided online is a demo. A demo number is a placeholder,
not the number you will use. DIDWW provides a demo number when an actual number cannot be shown or allocated before
registration, for example because numbers are not in stock or the supplier allows allocation only after the end-user
documents are approved.

The demo number stays in **Awaiting Registration** status until its registration is complete. After the verification
request is approved, the demo number is replaced with an active number, which can have different digits.

To get the active number:

1. Create an identity and address that match the requirement. See [Create identity and address](how-to-guides/create-identity-and-address.html#create-new-identity).
2. Assign them to the number. See [Assign end-user details](../phone-numbers/my-numbers/how-to-guides/assign-end-user-details.html).
3. Wait for the DIDWW Compliance Team to approve the verification request.

## Requirements and documents

Each service has its own requirements for every country and number or Sender ID type. A requirement decides which
identity types are accepted, which details are needed and which documents to upload. It can also restrict where the
address must be, for example in the area of the number, and say whether the number provided online is a demo.

The **Requirements** panel on the **New Identity** and **New Address** pages shows the requirement before you enter any
details. You select the service **Type**, the **Country** and, depending on the service, the **Number type** or **Sender
ID type**. After you enter the details and upload the documents, the panel checks them against the requirement. For the
steps, see [Create identity and address](how-to-guides/create-identity-and-address.html#create-new-identity).

### Documents

A requirement can ask for three kinds of documents:

| Document | Purpose |
| --- | --- |
| Proofs of identity | Confirm who the end user is, for example a passport or a national ID. Business identities use company documents, such as an incorporation certificate, and documents of the representative. |
| Proofs of address | Confirm the address, for example a utility bill or a copy of a phone bill. |
| Supporting Documents | Additional files the requirement asks for, such as a country registration form. If the requirement includes a form, you download it, complete it and upload it. |

For the accepted proof types and upload rules, see the [Identities reference](identities.html#user-panel-identities) and
the [Addresses reference](addresses.html#user-panel-addresses).

Important

- Providing incorrect or insufficient documents may result in a delayed or declined registration process.
- All file content is encrypted with AES-256-CBC and stored on DIDWW servers. Only authorized parties can decrypt it, using private keys stored in a Hardware Security Module (HSM).

## Related resources

- [Create identity and address](how-to-guides/create-identity-and-address.html#create-new-identity)
- [Identities reference](identities.html#user-panel-identities)
- [Addresses reference](addresses.html#user-panel-addresses)
- [How DID number verification works](verifications/how-did-number-verification-works.html#user-panel-how-did-verification-works)
- [Account setup](../account-settings/account-setup.html#user-panel-account-verification)
