Skip to main content
GET
/
orgs
/
{org_id}
/
k2
/
{kb_id}
/
files
/
{file_id}
cURL
curl --request GET \
  --url https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id} \
  --header 'Authorization: Bearer <token>'
{
  "content_length": 123,
  "content_type": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "id": 123,
  "kb_id": 123,
  "metadata": "<unknown>",
  "name": "<string>",
  "parse_state": "<string>",
  "uid": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "embeddings": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "kb_file_id": 123,
      "model": "<string>",
      "provider": "<string>",
      "status": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "chunk_count": 123,
      "cost_usd": 123,
      "error": "<string>",
      "parsing_id": 123,
      "token_count": 123
    }
  ],
  "parsings": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "kb_file_id": 123,
      "provider": "<string>",
      "status": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "chunk_count": 123,
      "cost_usd": 123,
      "error": "<string>",
      "num_pages": 123,
      "provider_job_id": "<string>",
      "s3_bucket": "<string>",
      "s3_key": "<string>"
    }
  ],
  "directory": "<string>"
}
Listings from GET /orgs/{org_id}/k2/{kb_id}/files include folder rows (content_type application/vnd.timbal.k2-directory). This get file endpoint is only for regular uploaded files (parsings, embeddings, etc.). If you pass a directory row’s id from the list endpoint, the API responds with 404 Not Found — virtual directories do not have a full file payload here.

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
kb_id
string
required
file_id
string
required

Response

200 - application/json

File details with parsings and embeddings

content_length
integer<int64>
required
content_type
string
required
created_at
string<date-time>
required
id
integer<int64>
required
kb_id
integer<int64>
required
metadata
any
required
name
string
required
parse_state
string
required

Pipeline state for parsing + embedding.

One of pending (pipeline in flight), success (parse + embed both completed), failed (latest attempt failed), or skipped (format unsupported, never parsed). Unsupported files are stored as-is; the indicator lets clients flag them in listings rather than rejecting the upload.

uid
string
required
updated_at
string<date-time>
required
url
string
required
embeddings
object[]
required
parsings
object[]
required
directory
string | null