---
title: "List folder app item associations"
method: GET
path: "/folders/{folder_id}/app_item_associations"
tags: ["App item associations"]
---

# List folder app item associations

`GET /folders/{folder_id}/app_item_associations`

**This is a beta feature, which means that its availability might be limited.**
Returns all app items the folder is associated with. This includes app items
associated with ancestors of the folder. Assuming the context user has access
to the folder, the type/ids are revealed even if the context user does not
have **View** permission on the app item.

## Path parameters

- `folder_id` string, required

## Query parameters

- `limit` integer
- `marker` string
- `application_type` string

## Response `200`

Returns a collection of app item objects. If there are no
app items on this folder an empty collection will be returned.
This list includes app items on ancestors of this folder.

- AppItemAssociations — The part of an API response that describes marker based pagination.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `next_marker` string, nullable — The marker for the start of the next page of results.
  - `prev_marker` string, nullable — The marker for the start of the previous page of results.
  - `entries` AppItemAssociation[]
    - `id` string, required — The unique identifier for this app item association.
    - `type` 'app_item_association', required — The value will always be `app_item_association`.
    - `app_item` object, required — The app item which is associated with the file or folder.
      - `id` string, required — The unique identifier for this app item.
      - `type` 'app_item', required — The value will always be `app_item`.
      - `application_type` string, required — The type of the app that owns this app item.
    - `item` union, required — The file, folder or web link which is associated with the app item.
      - object, nullable — The bare basic representation of a file, the minimal amount of fields returned when using the `fields` query parameter.
        - `id` string, required — The unique identifier that represent a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.
        - `etag` string, nullable — The HTTP `etag` of this file. This can be used within some API endpoints in the `If-Match` and `If-None-Match` headers to only perform changes on the file if (no) changes have happened.
        - `type` 'file', required — The value will always be `file`.
      - object — The bare basic representation of a folder, the minimal amount of fields returned when using the `fields` query parameter.
        - `id` string, required — The unique identifier that represent a folder. The ID for any folder can be determined by visiting a folder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/folders/123` the `folder_id` is `123`.
        - `etag` string, nullable — The HTTP `etag` of this folder. This can be used within some API endpoints in the `If-Match` and `If-None-Match` headers to only perform changes on the folder if (no) changes have happened.
        - `type` 'folder', required — The value will always be `folder`.
      - object — Web links are objects that point to URLs. These objects are also known as bookmarks within the Box web application. Web link objects are treated similarly to file objects, they will also support most actions that apply to regular files.
        - `id` string, required — The unique identifier for this web link.
        - `type` 'web_link', required — The value will always be `web_link`.
        - `etag` string — The entity tag of this web link. Used with `If-Match` headers.

## Other responses

- `404` — Returned if the folder is not found, or the user does not have access to the folder.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)