> For the complete documentation index, see [llms.txt](https://docs.whitearrow.com/white-arrow-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whitearrow.com/white-arrow-api-documentation/get-files.md).

# Get Files

**GET v2/{modelType}/{modelID}/files**

Returns the file or list of files pertaining to the specific model object.

#### The Endpoints

```http
v2/{modelType}/{modelID}/files/{fileID}
```

```http
v2/{modelType}/{modelID}/files/
```

### Examples

## Get File

```html
GET https://api.test.archer-app.com/v2/loads/999999/files/100001
```

## Get Files

```http
GET https://api.test.archer-app.com/v2/loads/999999/files
```

***

### Body Object

None

## ExampleBody

None

***

## Response

Returns the file or an array of files pertaining to the object.

### Response Properties

| Name        | Type   | Description           |
| ----------- | ------ | --------------------- |
| id          | int    | File Id.              |
| modelType   | string | Model name.           |
| modelId     | int    | Model Id.             |
| description | string | Description Type Enum |
| name        | string | The file name.        |

#### Possible values for description

* Accessorial Confirmation Backup
* Rate Confirmation
* POD
* Invoice
* PickUp Document

## Example Response

The file will be returned if a single file is queried.

Returns all details of the files pertaining to the object:

```json
[
  {
    "id": 1000001,
    "modelType": "Load",
    "modelId": 999999,
    "description": "Invoice",
    "name": "Load_999999_Invoice_1522351748.pdf",
    "token": "asdfadsf"
  },
  {
    "id": 1000002,
    "modelType": "Load",
    "modelId": 999999,
    "description": "Rate Confirmation",
    "name": "Load_999999_Rate Confirmation_1522785648.pdf",
    "token": "zzAow76x"
  }
]
```

## Example Error Response

**The file Id was not found.**

```json
{
  "message": "NoSuchKey: The specified key does not exist.....",
  "title": "Internal Error"
}
```

***

***