---
title: "List file app item associations"
method: GET
path: "/files/{file_id}/app_item_associations"
tags: ["App item associations"]
---

# List file app item associations

`GET /files/{file_id}/app_item_associations`

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

## Path parameters

- `file_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 file, an empty collection will be returned.
This list includes app items on ancestors of this File.

- 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 file is not found, or the user does not have access to the file.
- `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)