---
title: "List Files"
method: GET
path: "/files"
---

# List Files

`GET /files`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `purpose.in` string[] — Filter Files for those with the specified purpose or purposes. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

File List

- FileList — A list of File objects.
  - `data` File[], required — The contents of the list.
    - `created_at` string, date-time, required — The time the File was created.
    - `description` string, nullable, required — A description of the File.
    - `direction` 'to_increase' | 'from_increase', required — Whether the File was generated by Increase or by you and sent to Increase.
    - `filename` string, nullable, required — The filename that was provided upon upload or generated by Increase.
    - `id` string, required — The File's identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `mime_type` string, required — The MIME type of the file.
    - `purpose` 'card_dispute_attachment' | 'check_image_front' | 'check_image_back' | 'processed_check_image_front' | 'processed_check_image_back' | 'mailed_check_image' | 'check_attachment' | 'check_voucher_image' | 'check_signature' | 'inbound_mail_item' | 'form_1099_int' | 'form_1099_misc' | 'form_ss_4' | 'identity_document' | 'increase_statement' | 'loan_application_supplemental_document' | 'other' | 'trust_formation_document' | 'digital_wallet_artwork' | 'digital_wallet_app_icon' | 'physical_card_front' | 'physical_card_back' | 'physical_card_carrier' | 'document_request' | 'entity_supplemental_document' | 'export' | 'fee_statement' | 'unusual_activity_report_attachment' | 'deposit_account_control_agreement' | 'proof_of_authorization_request_submission' | 'account_verification_letter' | 'funding_instructions' | 'hold_harmless_letter', required — What the File will be used for. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
    - `type` 'file', required — A constant representing the object's type. For this resource it will always be `file`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)