Reference · Directories

# GET/directory/{dirId}

Lists the files in one directory: the inputs you registered and the outputs jobs have written.

## Parameters

Parameters

- `dirId` (string): The directory’s id.

## Request body

This request has no body.

## Example

Request

```bash
curl https://media.logicboostkit.com/directory/dir_pi23jgy1yxlmigi873bz \
  -H "Authorization: Basic $MEDIA_KEY"
```

Response

```http
HTTP/1.1 200 OK
X-Request-Id: job_0mv6iv6v5rmhf80bjaztl3yl

{
  "ok": true,
  "files": [
    {
      "file_name": "source.mp4",
      "added_on": "2026-10-13T09:41:07.214Z"
    },
    {
      "file_name": "thumb.jpg",
      "added_on": "2026-10-13T09:43:21.870Z"
    }
  ]
}
```

## Response fields

Response fields

- `ok` (boolean): true when the directory exists.
- `files[]` (array): One entry per file. Empty when there are none.
- `files[].file_name` (string): The file’s name.
- `files[].added_on` (string): When it was registered or written, in UTC.

## Status codes

Status codes

- **200**: The list. Not charged.
- **401**: The `Authorization` header is missing, or the key is invalid, revoked or expired.
- **403**: The account isn’t active. The error says what to do.
- **404**: `Directory not found`: it isn’t in your account, or it has expired.
- **429**: More than 300 requests in a minute on this key. Wait for the number of seconds in `Retry-After`.

Every error has the shape `{"ok": false, "error": "…"}` and is never charged.