Reference · Directories

# GET/directory

Lists your account’s directories that have not expired. With a new key it is also the quickest way to check that the key works.

## Request body

This request has no body.

## Example

Request

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

Response

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

{
  "ok": true,
  "directories": [
    {
      "id": "dir_pi23jgy1yxlmigi873bz",
      "ttl": 86400,
      "added_on": "2026-10-13T09:41:07.214Z"
    },
    {
      "id": "dir_m8papv92jrn8rx6186g8",
      "ttl": 3600,
      "added_on": "2026-10-13T10:05:40.019Z"
    }
  ]
}
```

## Response fields

Response fields

- `ok` (boolean): true.
- `directories[]` (array): One entry per directory. Empty when there are none.
- `directories[].id` (string): The directory’s id.
- `directories[].ttl` (number): Its lifetime in seconds, counted from added_on.
- `directories[].added_on` (string): When it was created, 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.
- **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.