> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# List Files

> List all the files on your Pinata account

For more detailed information on listing and querying your files on IPFS, visit the [Listing Files doc](/files/listing-files).


## OpenAPI

````yaml get /data/pinList
openapi: 3.0.0
info:
  title: Pinata API
  description: ''
  termsOfService: https://www.pinata.cloud/terms-conditions
  contact:
    name: Pinata Team
    email: team@pinata.cloud
  version: 1.0.0
servers:
  - url: https://api.pinata.cloud
security:
  - bearerAuth: []
paths:
  /data/pinList:
    get:
      summary: List Files
      description: List all the files on your Pinata account
      parameters:
        - name: includeCount
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: boolean
            example: false
          examples:
            default:
              value: false
        - name: cid
          in: query
          description: CID of file you are searching for
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: groupId
          in: query
          description: Filters by group id if applicable
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pinStart
          in: query
          description: >-
            ISO_8601 format date to filter by start date for when file was
            pinned
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pinEnd
          in: query
          description: ISO_8601 format date to filter by end date for when file was pinned
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: unpinStart
          in: query
          description: >-
            ISO_8601 format date to filter by start date for when file was
            unpinned
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: unpinEnd
          in: query
          description: >-
            ISO_8601 format date to filter by end date for when file was
            unpinned
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pinSizeMin
          in: query
          description: Minimum size in bytes of files to return
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pinSizeMax
          in: query
          description: Maximum size in bytes of files to return
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: status
          in: query
          description: Options are "all", "pinned", or "unpinned"
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pageLimit
          in: query
          description: Maximum number of files to return. Default is 10, max is 1000
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: pageOffset
          in: query
          description: Use to paginate through files, default is 0
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: metadata
          in: query
          description: See metadata querying section below
          required: false
          style: form
          explode: true
          schema:
            type: string
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  rows:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        ipfs_pin_hash:
                          type: string
                        size:
                          type: integer
                        user_id:
                          type: string
                          format: uuid
                        date_pinned:
                          type: string
                          format: date-time
                        date_unpinned:
                          type: string
                          format: date-time
                          nullable: true
                        metadata:
                          type: object
                          properties:
                            name:
                              type: string
                            keyvalues:
                              type: object
                              additionalProperties:
                                type: integer
                        regions:
                          type: array
                          items:
                            type: object
                            properties:
                              regionId:
                                type: string
                              currentReplicationCount:
                                type: integer
                              desiredReplicationCount:
                                type: integer
                        mime_type:
                          type: string
                          nullable: true
                        number_of_files:
                          type: integer
      security:
        - bearerAuth: []
      servers:
        - url: https://api.pinata.cloud
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````