# Retrieve the list of masking file uploads.

Endpoint: GET /masking-file-uploads
Version: 3.18.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 100.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies a descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    ID of file.

  - `items.description` (string)
    A description of this file.

  - `items.filename` (string)
    Name of this file.

  - `items.file_checksum` (string)
    Checksum of this file.

  - `items.file_size` (integer)
    Size of this file in bytes.

  - `items.created_date` (string)
    Date that this file was created.

  - `items.file_reference_id` (string)
    A reference to this file.

  - `items.engine_file_uuid` (string)
    file uuid of the corresponding file on the source masking engine.

  - `items.engine_name` (string)
    The name of the origin engine that this file belongs to.
    Example: Compliance Engine 1

  - `items.engine_id` (string)
    The id of the origin engine that this file belongs to.
    Example: a638d976-6b7e-43f4-9212-90f4dc6d405c

  - `items.tags` (array)
    Tags of this file.

  - `items.tags.key` (string, required)
    Key of the tag
    Example: key-1

  - `items.tags.value` (string, required)
    Value of the tag
    Example: value-1

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.