# Index a person's documents

Returns an array containing all documents linked to the person specified in the request URL.

Endpoint: GET /v1/persons/{person_id}/documents
Version: 1.0

## Path parameters:

  - `person_id` (string, required)

## Query parameters:

  - `page[number]` (string)
    The number of results pages to return.

  - `page[size]` (string)
    The size of each page in the response.

  - `customer_accessible` (boolean)
    Use this parameter to return only the documents that the customer may access.

  - `include_deleted` (boolean)
    Use this parameter to include deleted documents in the results.

  - `sort` (string)
    Sorts the results by the date the document was created.
    Enum: "created_at"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier of the document.
    Example: "69ec2a9d8dbaf5ea1b13124098a34ea3cdoc"

  - `name` (string)
    The name of the file associated with the document.
    Example: "Operation_authorization.png"

  - `content_type` (string)
    The content type of the file associated with the document.
    Example: "image/png"

  - `document_type` (string)
    The type of document.
    Enum: "ACCOUNT_SNAPSHOT.FINTECSYSTEMS", "ACCOUNT_STATEMENT", "AML_POLICY", "ANNUAL_FINANCIAL_STATEMENT", "B2B_MANDATE", "BALANCE_REPORT", "BANK_REFERENCE", "BUSINESS_ASSESSMENT", "BUSINESS_FINANCIALS_XBRL", "CREDIT_AGENCY_REPORT", "CREDIT_RECORD.SCHUFA", "CUSTOMER_COMMUNICATION", "FATCA_SELF_DECLARATION", "FOUNDATION_DOCUMENT", "ID_DOCUMENT", "INVOICE", "KYC_BENEFICIAL_OWNER", "KYC_CORPORATE_DOCUMENT", "KYC_FORM", "KYC_LEGAL_REPRESENTATIVE", "KYC_RELIABILITY_CHECK", "KYC_REPORT", "LOAN_MANDATE_CONTRACT", "OTHER", "PAYMENT_CONFIRMATION", "PICTURE", "POWER_OF_ATTORNEY", "PROOF_OF_ADDRESS", "PROOF_OF_PHONE_CHANGE", "PROOF_OF_PROFESSION", "PROOF_OF_SALARY", "PROOF_OF_TAX_ID", "REFERENCE_LETTER", "REGISTER_APPLICATION", "REGISTER_EXTRACT", "SALARY_INFORMATION", "SCHUFA_COMPACT_REPORT", "SCHUFA_FULL_REPORT", "SCHUFA_GWG_REPORT", "SCHUFA_SHORT_REPORT", "SCORE_CARD.SOLARIS", "SCREENING_REPORT", "SHAREHOLDERS_LIST", "SHARE_HOLDERS_AGREEMENT", "SIGNATURE", "SIGNED_CONTRACT", "SIGNED_LOAN_MANDATE_CONTRACT", "TRADING_LICENSE", "TRANSACTIONAL_DOCUMENT", "TRANSFER_CANCELLATION", "VAT_CERTIFICATE", "VIDEO"

  - `size` (integer)
    The file size, in bytes.
    Example: 10187

  - `customer_accessible` (boolean)
    Indicates whether the customer has access to the document.

  - `created_at` (string)
    UTC timestamp from when the document was created in Solaris' system.
    Example: "2022-05-20T12:46:09Z"

  - `deleted_at` (string)
    UTC timestamp from when the document was deleted (if applicable).
    Example: "null"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

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

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

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

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

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

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

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

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

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."