> ## Documentation Index > Fetch the complete documentation index at: https://kiflo-b3d3c9c0.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List assets > Lists the assets of the library. When 'folder_id' is provided, only the direct children of that folder are returned (the listing is not recursive). When 'folder_id' is omitted, all assets across every folder level are returned as a flat, paginated list. For File and Cobranded assets, the 'downloadUrl' is a pre-signed link that is valid for 3 hours only. Once it expires, list the asset again to obtain a fresh link. ## OpenAPI ````yaml /openapi.json get /v3/assets openapi: 3.0.1 info: title: Kiflo Public API v3 description: "The Kiflo API allows you to have control over your integration and create the best experiences.\r\n\r\n***\r\n\r\n## Format\r\n\r\nThe API follows the REST standard using JSON to format requests and responses. \r\nDecimals are formatted using invariant culture, ie: using \".\" (dot) as a decimal sperator and no thousands separator. \r\nDates are formatted using ISO standards, in UTC format, including the timezone. Ex: 2015-03-25T12:00:00Z\r\n\r\n***\r\n\r\n## Security\r\n\r\nThe API is secured using an API token.\r\n\r\n**How to generate an API Access Token** \r\n 1. Open your [account settings page](https://app.kiflo.com/account/integration)\r\n 2. Go to the \"API Access Token\" section\r\n 3. Click \"Add\" button\r\n 4. Choose a name that will be used to identify the token and click \"Add\"\r\n 4. Copy the generate token\r\n \r\n> **Note:** For security reason, the generated API Access Token won't be visible after you close the settings page. Be sure to copy the generated token otherwise you won't be able to get it later.\r\n \r\n**How to authenticate on the API** \r\n \r\nTo authenticate on the API, send the generated token in the Authorization header using the Bearer scheme: \r\n`Authorization: Bearer #YOUR_GENERATED_TOKEN_HERE#`\r\n" version: v3 servers: [] security: [] paths: /v3/assets: get: tags: - Assets summary: List assets description: "Lists the assets of the library. When 'folder_id' is provided, only the direct children of that folder are returned (the listing is not recursive).\r\nWhen 'folder_id' is omitted, all assets across every folder level are returned as a flat, paginated list.\r\n \r\nFor File and Cobranded assets, the 'downloadUrl' is a pre-signed link that is valid for 3 hours only. Once it expires, list the asset again to obtain a fresh link." parameters: - name: folder_id in: query description: "Lists the assets directly inside this folder.\r\nWhen omitted, all assets across every folder level are returned as a flat list." schema: type: integer format: int32 - name: type in: query description: "Filters assets on their type.\r\nWhen omitted, assets of every type are returned." schema: $ref: '#/components/schemas/AssetType' - name: offset in: query description: >- The cursor used in pagination. This is the index of the first asset to be returned. schema: type: integer format: int32 - name: limit in: query description: The maximum number of assets to be returned. The default is 20. schema: type: integer format: int32 - name: sort_by in: query description: The property used to sort the assets by. The default is Name. schema: type: string - name: order_by in: query description: >- The sorting direction for the returned assets. Accepted values: ASC, DESC. The default is ASC. schema: type: string responses: '200': description: Assets returned content: application/json: schema: $ref: '#/components/schemas/AssetListResponseDto' example: items: - id: 1 name: Sales collateral description: Documents shared with partners. type: Folder parentFolderId: null sharingType: Public downloadUrl: null url: null originalFileName: null creationDate: '2026-04-22T10:06:00Z' updateDate: null - id: 2 name: Product one-pager description: A short overview of the product. type: File parentFolderId: null sharingType: Restricted downloadUrl: >- https://storage.kiflo.com/tenant-container/9f1c2b7a-3d4e-4f5a-8b6c-7d8e9f0a1b2c?sv=2023-11-03&se=2026-04-22T13%3A06%3A00Z&sig=Rq9pexampleSignatureValue%3D url: null originalFileName: product-one-pager.pdf creationDate: '2026-04-22T10:06:00Z' updateDate: '2026-04-23T08:15:00Z' - id: 3 name: Partner portal description: Link to the partner portal. type: Url parentFolderId: null sharingType: Public downloadUrl: null url: https://partners.kiflo.com originalFileName: null creationDate: '2026-04-22T10:06:00Z' updateDate: null paginationSkipCount: 0 totalCount: 3 '400': description: Invalid request '403': description: Asset feature is not available security: - oauth2: - Asset.View - Api components: schemas: AssetType: enum: - Unknown - File - Url - Cobranded - Folder type: string AssetListResponseDto: type: object properties: items: type: array items: $ref: '#/components/schemas/AssetDto' nullable: true paginationSkipCount: type: integer format: int32 totalCount: type: integer description: >- Gets or sets the total number of items that could be returned by this command (without pagination). format: int32 additionalProperties: false AssetDto: type: object properties: id: type: integer description: The unique identifier of the asset. format: int32 name: type: string description: The name of the asset. nullable: true description: type: string description: The description of the asset. nullable: true type: $ref: '#/components/schemas/AssetType' parentFolderId: type: integer description: >- The identifier of the folder that contains this asset. Empty when the asset is in the root (no parent folder). format: int32 nullable: true sharingType: $ref: '#/components/schemas/SharingType' downloadUrl: type: string description: "A pre-signed link to download the file, valid for 3 hours only. Set only for File and Cobranded assets; empty otherwise.\r\nOnce it expires, list the asset again to obtain a fresh link." nullable: true url: type: string description: >- The external web link the asset points to. Set only for Url assets; empty otherwise. nullable: true originalFileName: type: string description: >- The original name of the uploaded file. Set only for File and Cobranded assets; empty otherwise. nullable: true creationDate: type: string description: The date and time the asset was created, in UTC. format: date-time updateDate: type: string description: >- The date and time the asset was last updated, in UTC. Empty when the asset has never been updated. format: date-time nullable: true additionalProperties: false SharingType: enum: - Unknown - Private - Restricted - Public type: string ````