GET api/file/{id}

Retrieves detailed metadata for a specific file by its node ID.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The internal node ID of the file to retrieve. This ID must correspond to a valid, non-deleted file in the system.

integer

Required

Body Parameters

None.

Response Information

Resource Description

On success: HTTP 200 OK with a structured `SDFile` object. On failure: HTTP 403 Forbidden if access is denied, or 400 Bad Request on error.

SDFile
NameDescriptionTypeAdditional information
version

File Version

integer

None.

size

File Size in bytes

integer

None.

i_node

Unique database id of the item

integer

None.

f_node

Unique database id of the item's parent, this is needed sometimes to figure out the structure of the content

integer

None.

item

Name\Title of the item

string

None.

description

Description of the item

string

None.

creator

User details who created the item

ViewUserDTO

None.

status

Current status of the item

string

None.

Response Formats

application/json, text/json

Sample:
{
  "version": 1,
  "size": 2,
  "i_node": 3,
  "f_node": 4,
  "item": "sample string 5",
  "description": "sample string 6",
  "creator": {
    "userID": 1,
    "userName": "sample string 2",
    "firstName": "sample string 3",
    "lastName": "sample string 4",
    "email": "sample string 5",
    "customFields": [
      {
        "values": [
          "sample string 1",
          "sample string 2"
        ],
        "guid": "sample string 1",
        "type": "sample string 2",
        "dataType": "sample string 3"
      },
      {
        "values": [
          "sample string 1",
          "sample string 2"
        ],
        "guid": "sample string 1",
        "type": "sample string 2",
        "dataType": "sample string 3"
      }
    ],
    "status": "sample string 6",
    "createDate": "2025-11-21T03:21:31.5229833+00:00",
    "groups": [
      {
        "name": "sample string 1",
        "id": 2
      },
      {
        "name": "sample string 1",
        "id": 2
      }
    ]
  },
  "status": "sample string 7"
}

application/scim+json

Sample:
{
  "version": 1,
  "size": 2,
  "i_node": 3,
  "f_node": 4,
  "item": "sample string 5",
  "description": "sample string 6",
  "creator": {
    "userID": 1,
    "userName": "sample string 2",
    "firstName": "sample string 3",
    "lastName": "sample string 4",
    "email": "sample string 5",
    "customFields": [
      {
        "values": [
          "sample string 1",
          "sample string 2"
        ],
        "guid": "sample string 1",
        "label": null,
        "type": "sample string 2",
        "dataType": "sample string 3"
      },
      {
        "values": [
          "sample string 1",
          "sample string 2"
        ],
        "guid": "sample string 1",
        "label": null,
        "type": "sample string 2",
        "dataType": "sample string 3"
      }
    ],
    "status": "sample string 6",
    "createDate": "2025-11-21T03:21:31.5229833+00:00",
    "groups": [
      {
        "name": "sample string 1",
        "id": 2
      },
      {
        "name": "sample string 1",
        "id": 2
      }
    ]
  },
  "status": "sample string 7"
}