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

# List files

> The co-op files (`coop_up2data`, `coop_harvestapi`, `coop_fetchin`): every LinkedIn profile any customer fetched through each provider, new every day. Each has its `id` and `is_unlocked`. Get a file with `POST /files/{file_id}/download-link/`. This call is free.



## OpenAPI

````yaml /openapi.json get /files/
openapi: 3.1.0
info:
  title: Datacircle API
  version: '1'
  description: >-
    Datacircle is a data co-op.


    Step 1: Query your favorite B2B data APIs through us. Same request, same
    price, no markup.


    Step 2: You're DONE. Every morning, you get the flat file of your data plus
    everyone else's.


    You send the provider's own request to api.datacircle.dev, with your
    Datacircle key. That's the only change.


    Right now we have 3 live LinkedIn profile APIs that we trust: Up2Data,
    HarvestAPI and Fetchin. Each request goes to the provider and gets the
    profile as it is today.


    Add \$50 to your account: you get \$50 of API PLUS the flat file.


    Sign up at datacircle.dev with your work email: a \$5 credit, that's 2,105
    LinkedIn profiles at \$2.375 per 1,000.


    Use it from Claude, ChatGPT or Cursor: add api.datacircle.dev/mcp as an MCP
    server.


    The docs: [docs.datacircle.dev](https://docs.datacircle.dev).
  termsOfService: https://datacircle.dev/terms
  contact:
    name: Datacircle
    url: https://datacircle.dev
    email: wayne@datacircle.dev
  x-logo:
    url: https://datacircle.dev/favicon.png
    altText: Datacircle
servers:
  - url: https://api.datacircle.dev
security:
  - token: []
tags:
  - name: Datacircle
    description: 'Your Datacircle account: balance, adding funds, files, API key.'
  - name: Up2Data
    description: >-
      LinkedIn Profile API: Up2Data's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: up2data`.
  - name: HarvestAPI
    description: >-
      LinkedIn Profile API: HarvestAPI's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: harvestapi`.
  - name: Fetchin
    description: >-
      LinkedIn Profile API: Fetchin's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: fetchin`.
externalDocs:
  description: Datacircle docs
  url: https://docs.datacircle.dev
paths:
  /files/:
    get:
      tags:
        - Datacircle
      summary: List files
      description: >-
        The co-op files (`coop_up2data`, `coop_harvestapi`, `coop_fetchin`):
        every LinkedIn profile any customer fetched through each provider, new
        every day. Each has its `id` and `is_unlocked`. Get a file with `POST
        /files/{file_id}/download-link/`. This call is free.
      responses:
        '200':
          description: Every file with `is_unlocked` for this workspace
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/File'
              example:
                - id: 86
                  dataset: coop_up2data
                  filename: coop_up2data.parquet
                  row_count: 189
                  size_bytes: 366561
                  sha256: >-
                    a67aeac82afed8661326e5e463549a015c734f4cbf78653fc3072d8753f7bab4
                  created_at: '2026-10-11T06:00:08.167565Z'
                  is_unlocked: true
                - id: 119
                  dataset: coop_harvestapi
                  filename: coop_harvestapi.parquet
                  row_count: 10697
                  size_bytes: 52102021
                  sha256: >-
                    cc8bde304c20c44b60e64f33de9a841cbba06330ef5bb9f6ce3a449bbd28c878
                  created_at: '2026-10-11T08:39:26.359177Z'
                  is_unlocked: true
                - id: 120
                  dataset: coop_fetchin
                  filename: coop_fetchin.parquet
                  row_count: 2
                  size_bytes: 139420
                  sha256: >-
                    66a9dd565ebc240af53a05250294b2d1fbc5e174c4e5bbeebd5cd1fdfe06c5c3
                  created_at: '2026-10-11T08:39:27.301311Z'
                  is_unlocked: true
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.
        dataset:
          type: string
          enum:
            - coop_up2data
            - coop_harvestapi
            - coop_fetchin
          description: >-
            Which dataset this file is a snapshot of: `coop_up2data`,
            `coop_harvestapi` and `coop_fetchin` are the co-op files: every
            LinkedIn profile fetched through Up2Data, through HarvestAPI and
            through Fetchin, one flat Parquet table each, rebuilt every day.
            Their columns are on [Dataset
            fields](https://docs.datacircle.dev/fields). `GET /files/` lists the
            newest file of each dataset.
        filename:
          type: string
          description: The download's file name, such as `coop_up2data.parquet`.
        row_count:
          type:
            - integer
            - 'null'
          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
            - 'null'
          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).
        is_unlocked:
          type: boolean
          description: >-
            Whether this workspace may download it: `true` once this workspace
            has added $50 in funds.
  securitySchemes:
    token:
      type: http
      scheme: bearer
      description: >-
        Your API key: `Authorization: Bearer <your API key>`. `Authorization:
        Token <your API key>` works too.

````

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