# Execute Individual Search

Executes a search using optional personal and address details.

Endpoint: POST /localSolutions/GB/verify/individual/directReport
Version: 1.10.9
Security: bearerToken

## Request fields (application/json):

  - `firstName` (string, required)
    First name of the individual.

  - `middleName` (string)
    Middle name of the individual.

  - `lastName` (string, required)
    Last name of the individual.

  - `dateOfBirth` (string, required)
    Date of birth of the individual.
    Example: "YYYY-MM-DD"

  - `reasonForSearch` (string, required)
    Reason for performing the search.
    Enum: "AM", "AV", "BS", "CA", "DC", "DS", "EC", "GI", "QS", "TV", "GC", "SA", "IA"

  - `title` (string)
    Title of the individual.

  - `addresses` (object, required)

  - `addresses.currentAddress` (object, required)

  - `addresses.currentAddress.postCode` (string, required)
    Postal code of the address.

  - `addresses.currentAddress.addressLine` (string)
    Full address line. You can provide either addressLine OR the component fields (buildingNo, buildingName, subBuilding, street, town, county).

  - `addresses.currentAddress.buildingNo` (string)
    Building number of the address.

  - `addresses.currentAddress.buildingName` (string)
    Building name of the address.

  - `addresses.currentAddress.subBuilding` (string)
    Sub building of the address.

  - `addresses.currentAddress.street` (string)
    Street of the address.

  - `addresses.currentAddress.town` (string)
    Town of the address.

  - `addresses.currentAddress.county` (string)
    County of the address.

  - `addresses.previousAddresses` (array)
    Previous addresses (optional, max 2 items).

  - `addresses.previousAddresses.position` (integer, required)
    Position of the previous address (1 for first previous, 2 for second previous).

## Response 200 fields (application/json):

  - `verifyMatch` (boolean)
    Indicates if the verification matches (true if ANY address matched). Aggregated from all address results using OR logic.

  - `flags` (object)
    Top-level aggregated flags. Each flag is true if ANY address has the flag set to true (aggregated using OR logic). Always present in response.

  - `flags.ccjMatch` (boolean)
    Indicates a CCJ match for the individual.

  - `flags.electoralRegisterMatch` (boolean)
    Indicates an electoral roll match on an individual.

  - `flags.deceasedRegisterMatch` (boolean)
    Indicates a deceased match against an individual.

  - `flags.insolvencyMatch` (boolean)
    Indicates an insolvency match against an individual.

  - `directorships` (array)
    Company directorships for the individual. Always present in response (may be empty array). Only populated when PNR is matched and customer has Full (3136) backend flag. Ordered by appointment status: Current, then Resigned, then Dissolved.

  - `directorships.pnr` (string)
    Person Number Reference (PNR) associated with this directorship.
    Example: "24137254"

  - `directorships.companyName` (string)
    Name of the company.
    Example: "Creditsafe Business Solutions"

  - `directorships.companyNumber` (string)
    Company registration number.
    Example: "00445790"

  - `directorships.appointmentStatus` (string)
    Status of the directorship appointment. Mapped from backend codes: "01" = "Current", "03" = "Resigned". Note: In case the company status is "Dissolved", the appointment status would be "Dissolved" as well.
    Enum: "Current", "Resigned", "Dissolved"

  - `directorships.companyStatus` (string)
    Current status of the company. Mapped from backend codes: "C" = "Closed", "D" = "Dissolved", "L" = "Liquidation", "R" = "Receivership", space = "Active", "$" = "Insufficient information".
    Enum: "Active", "Closed", "Dissolved", "Liquidation", "Receivership", "Insufficient information"

  - `addresses` (object)
    Address verification results matching the request structure. Always present in response.

  - `addresses.currentAddress` (object, required)
    Current address result object. All fields (flags and arrays) are always present in the response, regardless of customData pseudo ID. Arrays may be empty [] and flags may be false based on the pseudo ID used.

  - `addresses.currentAddress.postCode` (string)
    Postal code of the address from the request body.

  - `addresses.currentAddress.addressLine` (string)
    Full address line from the request body.

  - `addresses.currentAddress.verifyMatch` (boolean)
    Indicates if the verification matches for this address.

  - `addresses.currentAddress.flags` (object)
    Flags for this address. Always present in response.

  - `addresses.currentAddress.countyCourtJudgments` (array)

  - `addresses.currentAddress.countyCourtJudgments.name` (string)
    Full name.

  - `addresses.currentAddress.countyCourtJudgments.amount` (object)

  - `addresses.currentAddress.countyCourtJudgments.amount.currency` (string)
    The currency for the amount of the CCJ.

  - `addresses.currentAddress.countyCourtJudgments.amount.value` (integer)
    The value for the amount of the CCJ.

  - `addresses.currentAddress.countyCourtJudgments.date` (string)
    Date when the judgment was made.

  - `addresses.currentAddress.countyCourtJudgments.paidDate` (string)
    Date when the judgment was satisfied or canceled.

  - `addresses.currentAddress.countyCourtJudgments.status` (string)
    The type of transaction for the judgment.

  - `addresses.currentAddress.countyCourtJudgments.caseNumber` (string)
    CCJ case number

  - `addresses.currentAddress.countyCourtJudgments.category` (string)
    CCJ caseType

  - `addresses.currentAddress.countyCourtJudgments.fullAddress` (object)

  - `addresses.currentAddress.countyCourtJudgments.fullAddress.simpleValue` (string)
    Full address line.

  - `addresses.currentAddress.countyCourtJudgments.fullAddress.postCode` (string)
    Postcode for the full address line.

  - `addresses.currentAddress.countyCourtJudgments.partialAddress` (object)

  - `addresses.currentAddress.countyCourtJudgments.partialAddress.simpleValue` (string)
    Partial address line.

  - `addresses.currentAddress.electoralRolls` (array)

  - `addresses.currentAddress.electoralRolls.firstName` (string)
    First name of the individual.

  - `addresses.currentAddress.electoralRolls.middleName` (string)
    Middle name of the individual.

  - `addresses.currentAddress.electoralRolls.lastName` (string)
    Last name of the individual.

  - `addresses.currentAddress.electoralRolls.canvasYear` (integer)
    Electoral roll canvas year.

  - `addresses.currentAddress.deceased` (array)

  - `addresses.currentAddress.deceased.uniqueReferenceNumber` (string)
    Unique reference number for the deceased record.

  - `addresses.currentAddress.deceased.dateOfDeath` (string)
    Date of death.

  - `addresses.currentAddress.deceased.firstName` (string)
    First name of the deceased.

  - `addresses.currentAddress.deceased.middleName` (string)
    Middle name of the deceased.

  - `addresses.currentAddress.deceased.lastName` (string)
    Last name of the deceased.

  - `addresses.currentAddress.insolvencies` (array)

  - `addresses.currentAddress.insolvencies.individualDetails` (object)

  - `addresses.currentAddress.insolvencies.individualDetails.title` (string)
    Title of individual on Insolvency

  - `addresses.currentAddress.insolvencies.individualDetails.firstName` (string)
    First name of individual on Insolvency

  - `addresses.currentAddress.insolvencies.individualDetails.middleName` (string)
    Middle name of individual on Insolvency

  - `addresses.currentAddress.insolvencies.individualDetails.lastName` (string)
    Last name of individual on Insolvency

  - `addresses.currentAddress.insolvencies.individualDetails.occupation` (string)
    Occupation of individual on Insolvency

  - `addresses.currentAddress.insolvencies.caseDetails` (object)

  - `addresses.currentAddress.insolvencies.caseDetails.caseNumber` (string)
    Individual case number assigned to insolvency.

  - `addresses.currentAddress.insolvencies.caseDetails.caseType` (string)
    Type of insolvency.

  - `addresses.currentAddress.insolvencies.caseDetails.caseStatus` (string)
    Current status of the Insolvency.

  - `addresses.currentAddress.insolvencies.caseDetails.court` (string)
    Court name.

  - `addresses.currentAddress.insolvencies.caseDetails.courtNumber` (string)
    Court number.

  - `addresses.currentAddress.insolvencies.caseDetails.startDate` (string)
    Start date of the Insolvency.

  - `addresses.currentAddress.insolvencies.caseDetails.dischargeDate` (string)
    Date of insolvency annulment.

  - `addresses.previousAddresses` (object)
    Previous address result object. All fields (flags and arrays) are always present in the response, regardless of customData pseudo ID. Arrays may be empty [] and flags may be false based on the pseudo ID used.

  - `addresses.previousAddresses.position` (integer, required)
    Position of the previous address (1 for first previous, 2 for second previous), matching the request.

  - `requestDetails` (object)

  - `requestDetails.title` (string)
    Title of the individual from request.

  - `requestDetails.firstName` (string)
    First name of the individual from request.

  - `requestDetails.middleName` (string)
    Middle name of the individual from request.

  - `requestDetails.lastName` (string)
    Last name of the individual from request.

  - `requestDetails.dateOfBirth` (string)
    Date of birth of the individual from request.

  - `requestDetails.reasonForSearch` (string)
    Reason for performing the search from request.

  - `requestDetails.buildingNo` (string)
    Building number of the address from request.

  - `requestDetails.buildingName` (string)
    Building name of the address from request.

  - `requestDetails.subBuilding` (string)
    Sub building of the address from request.

  - `requestDetails.street` (string)
    Street of the address from request.

  - `requestDetails.town` (string)
    Town of the address from request.

  - `requestDetails.county` (string)
    County of the address from request.

  - `requestDetails.postcode` (string)
    Postal code of the address from request.

  - `requestDetails.addressLine` (string)
    Full address line from request.

  - `requestDetails.addresses` (object)
    Addresses from the request (used in multi-address search).

  - `requestDetails.addresses.currentAddress` (object, required)
    Current address details from request.

  - `requestDetails.addresses.currentAddress.postcode` (string)
    Postal code of the current address from request.

  - `requestDetails.addresses.currentAddress.addressLine` (string)
    Full address line of the current address from request.

  - `requestDetails.addresses.currentAddress.buildingNo` (string)
    Building number of the current address from request.

  - `requestDetails.addresses.currentAddress.buildingName` (string)
    Building name of the current address from request.

  - `requestDetails.addresses.currentAddress.subBuilding` (string)
    Sub building of the current address from request.

  - `requestDetails.addresses.currentAddress.street` (string)
    Street of the current address from request.

  - `requestDetails.addresses.currentAddress.town` (string)
    Town of the current address from request.

  - `requestDetails.addresses.currentAddress.county` (string)
    County of the current address from request.

  - `requestDetails.addresses.previousAddresses` (array)
    Previous addresses from request (max 2 items).

  - `requestDetails.addresses.previousAddresses.position` (integer)
    Position of the previous address (1 for first previous, 2 for second previous).

  - `requestDetails.addresses.previousAddresses.postcode` (string)
    Postal code of the previous address from request.

  - `requestDetails.addresses.previousAddresses.addressLine` (string)
    Full address line of the previous address from request.

  - `requestDetails.addresses.previousAddresses.buildingNo` (string)
    Building number of the previous address from request.

  - `requestDetails.addresses.previousAddresses.buildingName` (string)
    Building name of the previous address from request.

  - `requestDetails.addresses.previousAddresses.subBuilding` (string)
    Sub building of the previous address from request.

  - `requestDetails.addresses.previousAddresses.street` (string)
    Street of the previous address from request.

  - `requestDetails.addresses.previousAddresses.town` (string)
    Town of the previous address from request.

  - `requestDetails.addresses.previousAddresses.county` (string)
    County of the previous address from request.

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"