---
title: "Get all your Cannoli files paginated"
method: GET
path: "/figma/files_paginated/"
tags: ["Figma"]
---

# Get all your Cannoli files paginated

`GET /figma/files_paginated/`

## Request

- Base URL: `http://api.cannoli.app/api/v1`
- URL: `http://api.cannoli.app/api/v1/figma/files_paginated/`
- Auth: none declared

### Ordering
The file list is order by `created_at` descending. You can override the ordering through the 
`ordering` query parameter with the following fields:
* `created_at`
* `updated_at` 
* `name`  

Fields are ordered as ascending by default and you can change it to descending by adding `-` before
the field, eg `-created_at`

Here are a few examples to update the file list ordering.

Order by creation date, ascending

    /api/v1/figma/files_paginated/?ordering=created_at

Order by creation date, descending

    /api/v1/figma/files_paginated/?ordering=-created_at

You can also order by multiple fields separating by comma

    /api/v1/figma/files_paginated/?ordering=-created_at,name

### Pagination
This endpoint is paged to 30 results per page. You can override the page size with  the `page_size`
query parameter. You can also override the page number with the `page` query parameter.

    /api/v1/figma/files_paginated/?page_size=20&page=2

### Filtering
You can filter the file list by `team_id` using the `team` query parameter.

    /api/v1/figma/files_paginated/?team=<TEAM_ID>

You can also filter the file list by `project_id` using the `project` query parameter.

    /api/v1/figma/files_paginated/?project=<PROJECT_ID>

## Query parameters

- `ordering` string
- `page` integer
- `page_size` integer

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` FileList[], required
    - `id` integer
    - `name` string, nullable
    - `created_by` string
    - `figma_file_id` string
    - `node` string, required
    - `url` string, uri, required
    - `team` Team, required
      - `id` integer
      - `name` string, required
      - `organization` string
      - `owner` string
      - `permission` string
      - `logo` string, uri, nullable
      - `can_add_more_members` string
      - `projects` Project[]
        - `id` integer
        - `name` string, required
        - `team_id` string
        - `team_name` string
        - `created_at` string, date-time
        - `last_updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `public` boolean
    - `preview` string, uri, nullable
    - `project` Project, required
      - `id` integer
      - `name` string, required
      - `team_id` string
      - `team_name` string
      - `created_at` string, date-time
      - `last_updated_at` string, date-time
    - `plugin_metadata` object, nullable

---

[API](https://skmtc.dev/cannoli/apis/cannoli-backend-api.md) - [All operations](https://skmtc.dev/cannoli/apis/cannoli-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cannoli/apis/cannoli-backend-api/revisions/d27aef14fd7a?raw)