---
title: "Get a visible tenant project file"
method: GET
path: "/api/project-file/:projectId"
tags: ["Project files"]
---

# Get a visible tenant project file

`GET /api/project-file/:projectId`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/project-file/:projectId`
- Auth: none declared

## Path parameters

- `projectId` string, required

## Query parameters

- `token` string

## Response `200`

Tenant-scoped project result

- object
  - `projectId` string, required
  - `tenantId` string, required
  - `title` string, required
  - `lifecycle` 'ingesting' | 'ready' | 'degraded' | 'archived', required
  - `requiredClearance` string[], required
  - `createdBy` string, required
  - `members` string[]
  - `projectRefs` object[]
    - `caseId` string
    - `conversationId` string
  - `stats` object, required
    - `files` integer
    - `bytes` integer
    - `datasets` integer
    - `nodes` integer
    - `edges` integer
  - `deletion` object
    - `status` 'pending' | 'incomplete'
    - `failedHandlers` string[]
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `404`: Project absent or invisible to the authenticated principal
- `409`: Project archived or deletion in progress
- `503`: Deletion incomplete; retry after cleanup recovery

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)