# Get a page of documents in a specific folder

Endpoint: GET /documents
Version: 1.0
Security: bearerAuth

## Query parameters:

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

  - `level` (string, required)
    Filter by document level, e.g. CUSTOMER
    Enum: "CUSTOMER"

  - `levelId` (string, required)
    Filter by level id, e.g. customer id 1234
    Example: "0"

  - `parentDocumentId` (string)
    Filter by folder id, e.g. folder ABC with id 456, omitting this implies the root folder
    Example: "0"

  - `tags` (string)
    Filter by tag name
    Example: "xyz | in:x,y | like:xyz"

  - `name` (string)
    Filter by document name
    Example: "xyz | in:x,y | like:xyz"

  - `recursive` (string)
    Search all sub-folders below the folder level specified
    Example: "true | false"

## Response 200 fields (application/json):

  - `id` (integer)
    Document identifier
    Example: 1

  - `parentDocumentId` (integer)
    Parent document identifier
    Example: 1

  - `levelId` (integer)
    Level identifier, e.g. customer id
    Example: 1

  - `level` (string, required)
    Level of document
    Enum: "CUSTOMER"

  - `type` (string)
    Type of document
    Enum: "FILE", "FOLDER"

  - `name` (string, required)
    File of folder name
    Example: "/helloworld.doc"

  - `owner` (string)
    Owner of document, the person who uploaded the file or created the folder
    Example: "Tommy Tynan"

  - `ownerUserId` (integer)
    User id for the owner of the document
    Example: 1

  - `sizeInKb` (integer)
    Size of document in Kilo Byte (KB)
    Example: 1

  - `path` (string)
    Parent folder name, might be missing for root
    Example: "/folder1/folder2/"

  - `uploadDateTime` (string)
    File or folder upload date and time

  - `tags` (array)
    Zero or more tags associated with the file or folder. Might be 'Star' or 'Private' or even 'Deleted'

  - `tags.name` (string, required)
    Tag name


## Response 400 fields

## Response 401 fields

## Response 403 fields