1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75# Get Files
<span class="request">`GET` **/api/1.1/files**</span>
<span class="description">Get all files within the Directus File Library</span>
<span class="arguments">Name</span> | Value | Description
--------|-----|------------
**id** _Integer_ | <span class="required">Required</span> | The `id` of the file you wish to get
**limit** _Integer_ | <span class="default">Default **200**</span> | The number of items to request
**offset** _Integer_ | <span class="default">Default **0**</span> | The offset for for the items
**order[field]** _String_ | <span class="default">Default **ASC**</span> | Order to be sorted. Available options are: `ASC` (Ascending) or `DESC` (Descending)
**status** _String_ | <span class="default">Default **None**</span> | List of status values to be included. Separated by commas, eg: `1,2`
**columns** _String_ | <span class="default">Optional</span> | The columns to be shown on the result. Columns are separated by comma, eg: `columns=id,title,published_date`
**in[field]** _String_ | <span class="default">Optional</span> | Only list records that its `field` matches one of given value. Can be separated by commas, eg: `in[id]=1,2`
**ids** _String_ | <span class="default">Optional</span> | Only list records that its `field` matches one of given value. Can be separated by commas. `ids=1,2`. Same as `in[id]=1,2`
**filters** _Object_ | <span class="default">Optional</span> | Use the [`Filter Operators`](/overview/endpoints.md#supported-filters-operators) to filter the result <a class="object">Filter Object</a>
### Example Request
```bash
$ curl https://instance--key.directus.io/api/1.1/files \
-u [user-token]:
```
```php
$files = $client->getFiles();
```
```javascript
client.getFiles();
```
## Response
<span class="attributes">Attribute</span> | Description
--------|------------
**meta** _Meta Object_ | The Directus system metadata object that provides useful information not contained within the dataset itself [**Meta Object**: View Nested Attributes](/overview/objects-model.md#meta-object)
**data** _File Object Collection_ | <span class="custom">This data and its architecture is based on the Directus file schema and can be extended with additional custom columns</span> [**File Object**: View Nested Attributes](/overview/objects-model.md#file-object)
### Example Response
```json
{
"meta": {
"table": "directus_files",
"type": "collection",
"Active": 1,
"Delete": 0,
"Draft": 0,
"total": 1,
"total_entries": 1
},
"data": [{
"id": 1,
"active": 1,
"name": "2a05d2300cf0a8bf1a3f6567366affed.jpg",
"url": null,
"title": "My File Name",
"location": "",
"caption": "",
"type": "image\/jpg",
"charset": "binary",
"tags": "",
"width": 594,
"height": 447,
"size": 52155,
"embed_id": null,
"user": 1,
"date_uploaded": "2013-11-15 04:30:52 UTC",
"storage_adapter": "local"
}]
}
```