How identities, addresses, and verifications work#

In countries with 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.

Sender ID Verifications

Registers a Sender ID for A2P messaging. Only a Business identity can be used. See How Sender ID verification works.

Emergency Calling

Records the end user and the emergency service address of an Emergency Calling Service. See How Emergency Calling works.

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.

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.

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.

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 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.

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.

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 and the 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. 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.

  2. Assign them to the number. See Assign end-user details.

  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.

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 and the Addresses reference.

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).