# Retrieve a person by Id

This is used to fetch a person by its unique Id

Endpoint: GET /accounts/{id}/persons/{personId}
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `id` (string, required)
    the account id of one of your sub accounts
    Example: "ac_b83f2653-06d7-44a9-a548-5825e8186004"

  - `personId` (string, required)
    Person to retrieve
    Example: "per_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the person
    Example: "per_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `firstName` (string)
    The first name of the person
    Example: "Fred"

  - `middleNames` (string,null)
    The middle names of the person
    Example: "David"

  - `lastName` (string)
    The last name / surname of the person
    Example: "Jones"

  - `email` (string,null)
    The email address of the person
    Example: "fred.jones@example.com"

  - `dateOfBirth` (string)
    The date of birth of the person, in format YYYY-MM-DD
    Example: "1990-01-20"

  - `countryOfBirth` (string,null)
    The two-character ISO 3166 country code of birth of the person
    Example: "GB"

  - `gender` (string,null)
    The gender of the person. International regulations require either Female or Male
    Enum: "Female", "Male"

  - `nationalities` (array)
    The countries of citizenship or nationality of the person
    Example: ["GB"]

  - `address` (object)
    The address of the person

  - `phoneNumber` (string,null)
    The phone number of the person, in E.164 format
    Example: "+447900000000"

  - `businessRoles` (array)
    The role(s) in the business that the person performs
    Enum: "BusinessContact", "Director", "UltimateBeneficialOwner"

  - `verification` (object)
    the result of submitting a person for verification

  - `verification.status` (any)
    The verification status of the person

  - `verification.requiredFields` (array,null)
    A list of fields that must be provided for verification.

  - `verification.requiredFields.name` (string)
    The name of the field
    Example: "phoneNumber"

  - `verification.requiredDocuments` (array,null)
    A list of documents that must be provided for verification.

  - `verification.requiredDocuments.category` (string)
    The category of document, these are only applicable for certain entities:
- Authorization is only applicable for Persons
- ProofOfAddress is only applicable for Individuals or Persons
- ProofOfBusiness is only applicable for Businesses
- ProofOfIdentity is only applicable for Individuals or Persons
    Enum: "Authorization", "ProofOfAddress", "ProofOfBusiness", "ProofOfIdentity"

  - `verification.requiredDocuments.types` (array)
    The types of document available to upload in this category
    Enum: "BankStatement", "BusinessRegistration", "CreditCardStatement", "DriversLicense", "LetterOfAuthorization", "NationalId", "OfficialGovernmentLetter", "Passport", "PropertyTaxAssessment", "TaxReturn", "UtilityBill"

  - `verification.requiredDocuments.quantity` (integer)
    The minimum number of documents required of this category
    Example: 1

  - `verification.errors` (array,null)
    Details the errors returned if verification was unsuccessful. This could contain documents and/or fields.

  - `verification.errors.code` (string)
    Enum: "InvalidDocument", "InvalidField"

  - `verification.errors.id` (string)
    For InvalidDocument this will be the file id of the document that is invalid For InvalidField this will be the name of the field that is invalid
    Example: "fl_01HAAHFQKEF4V7S6H3BTA3H85G"

  - `verification.errors.description` (string)
    A description of why this document/field was invalid
    Example: "File corrupted or image not clear"

  - `documents` (array,null)
    The KYC documents

  - `metadata` (object,null)
    use this parameter to attach key-value data to the person. These will be sent with any associated account events on your webhooks. You can have a maximum of 5 pieces of metadata.
    Example: {"accountId":"1"}

  - `createdTimestamp` (integer)
    The epoch timestamp (seconds) when the person was created
    Example: 1470989538

  - `lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the person was last updated
    Example: 1470989538

## Response 404 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"