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

# List files



## OpenAPI

````yaml /openapi.json get /files/
openapi: 3.1.0
info:
  title: Datacircle API
  version: '1'
servers:
  - url: https://idle.api.datacircle.dev
security:
  - token: []
tags:
  - name: Datacircle
    description: 'Your Datacircle account: credits, checkout, files, invites, API key.'
  - name: iBlinked
    description: >-
      LinkedIn Profile API: iBlinked's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: iblinked`.
  - name: Up2Data
    description: >-
      LinkedIn Profile API: Up2Data's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: up2data`.
paths:
  /files/:
    get:
      tags:
        - Datacircle
      summary: List files
      responses:
        '200':
          description: Every file with `allowed` for this workspace
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/File'
components:
  schemas:
    File:
      type: object
      properties:
        id:
          type: integer
          description: >-
            The file's id: pass it to `POST /files/{file_id}/download-link/`.
            Every daily file gets a new id; old ids still download.
        rank:
          type: string
          enum:
            - us_10m
            - coop
            - us_50m
          description: >-
            Which file it is: `us_10m` is the 10M US dataset (10M+ US B2B
            leads), `us_50m` the 50M US dataset (50M+ US B2B), `coop` the co-op
            file: a Parquet file of every LinkedIn profile fetched through
            iBlinked, rebuilt every day. `GET /files/` lists the newest file of
            each rank.
        row_count:
          type: integer
          description: Rows in the file; `null` when we have not counted it.
        size_bytes:
          type: integer
          description: The file's size, in bytes.
        sha256:
          type: string
          description: >-
            The file's SHA-256, in hex, to check your download; `null` when we
            have not measured it.
        created_at:
          type: string
          format: date-time
          description: When the file was exported (ISO 8601).
        allowed:
          type: boolean
          description: >-
            Whether this workspace may download it: always `true` for `us_10m`;
            `true` for `coop` once this workspace spent 50 USD on credit or 3
            people you invited signed up (`coop_file_unlocked` in `GET
            /credits/`); `true` for `us_50m` only once 3 people you invited
            signed up (`GET /me/invites/`).
  securitySchemes:
    token:
      type: apiKey
      in: header
      name: Authorization
      description: '`Token <your API key>`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.