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

# Get Files Info

> Retrieve aggregated file statistics for the authenticated organization

## Overview

This endpoint returns aggregated statistics about all files belonging to your organization, including total file count, total bytes, and ingestion progress.

## Response

<ResponseField name="num_files" type="integer">
  Total number of files in the organization
</ResponseField>

<ResponseField name="num_bytes" type="integer">
  Combined size of all files in the organization, in bytes
</ResponseField>

<ResponseField name="num_ingested" type="integer">
  Number of files that have completed ingestion
</ResponseField>

<ResponseField name="last_updated" type="float">
  Unix timestamp of the last update to the file statistics
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl https://api.u1.archetypeai.app/v0.5/files/info \
    -H "Authorization: Bearer $ATAI_API_KEY"
  ```

  ```python Python theme={"system"}
  import requests
  import os

  api_key = os.environ.get("ATAI_API_KEY")

  response = requests.get(
      "https://api.u1.archetypeai.app/v0.5/files/info",
      headers={"Authorization": f"Bearer {api_key}"}
  )

  print(response.json())
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch(
    "https://api.u1.archetypeai.app/v0.5/files/info",
    {
      headers: {
        Authorization: `Bearer ${process.env.ATAI_API_KEY}`,
      },
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={"system"}
  {
    "num_files": 142,
    "num_bytes": 4831785472,
    "num_ingested": 138,
    "last_updated": 1745803938.214
  }
  ```

  ```json 401 - Unauthorized theme={"system"}
  {
    "errors": [
      {
        "code": "unauthorized_request",
        "message": "Unauthorized or invalid access.",
        "suggestion": "Provide valid authentication credentials and ensure they have the required permissions.",
        "error_uid": "err-xxxxxxxx"
      }
    ]
  }
  ```
</ResponseExample>