# Create a Credit Information User Registration

This API validates a users personal information which if successful will retrieve their credit profile.

Endpoint: POST /connect/users/v1/verification
Version: all
Security: Bearer

## Request fields (application/json-patch+json):

  - `customerReference` (string, required)
    Customer reference for the user in the Atto Credit Information Journey

  - `title` (string, required)
    The title of the user (e.g., Mr, Mrs, Ms, Dr).

  - `firstName` (string, required)
    The first name of the user.

  - `middleNames` (string)
    The middle names of the user (optional).

  - `lastName` (string, required)
    The last name of the user.

  - `dateOfBirth` (string, required)
    The date of birth of the user, which must be between 18 and 120 years ago.

  - `phoneNumber` (string, required)
    The phone number of the user, which must be in a valid phone format.

  - `emailAddress` (string, required)
    The email address of the user, which must be in a valid email format and between 5 and 255 characters long.

  - `address` (object, required)
    Address of a User

  - `address.abodeNumber` (string)
    Sub-building identifier (e.g., flat, apartment, or floor level).
Validation: Conditional; one of `AbodeNumber`, `BuildingName`,
or `BuildingNumber` is required. Length: 0–30 characters.
Accepts alphanumeric characters and descriptive text (e.g., "3F", "2/5", "Flat 1", "Apartment 1").
For Scottish addresses containing unit parts such as "2/1" or "1F3", place them here
rather than in `BuildingNumber` or `Address1`.

  - `address.buildingName` (string)
    The name of the building or property.
Validation: Conditional; one of `AbodeNumber`, `BuildingName`,
or `BuildingNumber` is required. Length: 0–50 characters.

  - `address.buildingNumber` (string)
    The street number or building number.
Validation: Conditional; one of `AbodeNumber`, `BuildingName`,
or `BuildingNumber` is required. Length: 0–12 characters.

  - `address.address1` (string)
    The primary street address line (e.g., street name).
Validation: Optional. Length: 1–50 characters.

  - `address.address2` (string)
    The secondary street address line (e.g., locality or additional street details).
Validation: Optional. Length: 1–50 characters.

  - `address.address3` (string)
    Additional address line for extended address or locality details.
Validation: Optional. Length: 1–50 characters.

  - `address.town` (string)
    The postal town or city.
Validation: Optional. Length: 1–25 characters.

  - `address.postCode` (string)
    The postal code for the address.
Validation: Mandatory. Length: 6–8 characters.
Must be formatted in standard UK postal notation with a single space separating
the outward and inward codes (e.g., "SW1A 1AA").

## Response 200 fields (application/json):

  - `status` (string)
    Enum: "Success", "Failed"

  - `message` (string)

  - `userId` (string)

  - `consentId` (string)

  - `customerReference` (string)

## Response 400 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

