# Get Proof Metadata Collection

GET /

#### Description

Retrieves metadata for a specified organization, control, label, or task, providing key contextual and configuration details.

Endpoint: GET /
Version: 1.0
Security: oauth2

## Query parameters:

  - `limit` (number)
    The maximum number of proof to return.

  - `sortBy` (string)
    The proof property to use when sorting the result.
    Enum: "createdBy", "uploadedOn"

  - `sortDirection` (string)
    The direction the data should be sorted.
    Enum: "asc", "desc"

  - `nextToken` (string)
    Token returned from a previous call to retrieve proof.

  - `objectType` (string)
    Linked object type.
    Enum: "control", "label"

  - `objectId` (string)
    Unique ID of the linked object.

## Response 200 fields (application/json):

  - `data` (array)
    A collection of proof.
    Example: [{"id":"4eb909de-51af-11ee-a644-522476618ae8","orgId":"ce83e3cd-5199-11ee-a644-522476618ae8","filename":"example.txt","contentType":"text/plain","fileExtension":"txt","size":627,"version":0,"source":"localComputer","ownedBy":"82d7c228-8bcd-11e9-a94b-ab3de8494987","uploadedOn":"2023-09-12T20:59:47.694353Z","isPrivate":false,"status":"active","createdBy":"82d7c228-8bcd-11e9-a94b-ab3de8494987","updatedBy":"82d7c228-8bcd-11e9-a94b-ab3de8494987","createdOn":"2023-09-12T20:59:47.694353Z","updatedOn":"2023-09-12T20:59:47.694353Z"}]

  - `data.id` (string)
    Unique identifier for the proof item
    Example: "4eb909de-51af-11ee-a644-522476618ae8"

  - `data.orgId` (string)
    Unique identifier for the organization
    Example: "ce83e3cd-5199-11ee-a644-522476618ae8"

  - `data.filename` (string)
    Name of the uploaded file
    Example: "example.txt"

  - `data.nameOverride` (string)
    Name of proof Hyperproof given by Hyperproof user

  - `data.contentType` (string)
    MIME type of the file (e.g.,text/plain)
    Example: "text/plain"

  - `data.fileExtension` (string)
    File extension (e.g.,txt)
    Example: "txt"

  - `data.size` (number)
    File size in bytes
    Example: 627

  - `data.version` (integer)
    Version of the proof item

  - `data.source` (string)
    Source of the file (e.g.,localComputer)
    Example: "localComputer"

  - `data.sourceVersion` (integer)
    The version of the proof maintained by the source system

  - `data.ownedBy` (string)
    Unique identifier of the user who owns the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `data.isPrivate` (boolean)
    Whether the proof item is private

  - `data.uploadedOn` (string)
    The date the proof was uploaded (ISO-8601 format)
    Example: "2023-09-12T20:59:47.694353Z"

  - `data.status` (string)
    Status of the proof item
    Enum: "active", "archived", "deleted", "pending", "canceled"

  - `data.createdBy` (string)
    Unique identifier of the user who created the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `data.createdOn` (string)
    The date the proof was created (ISO-8601 format)
    Example: "2023-09-12T20:59:47.694353Z"

  - `data.updatedBy` (string)
    Unique identifier of the user who last updated the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `data.updatedOn` (string)
    The date the proof was updated (ISO-8601 format)
    Example: "2023-09-12T20:59:47.694353Z"

  - `nextToken` (string)