> For the complete documentation index, see [llms.txt](https://rest-api.symphony.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rest-api.symphony.com/main/content-export-files/get-metadata.md).

# Get Metadata

## Get File Metadata

> Retrieves all metadata of a specific file. This endpoint is subject to audit.

```json
{"openapi":"3.0.3","info":{"title":"File Management API","version":"1.0.1"},"tags":[{"name":"Files","description":"Operations related to file management"}],"servers":[{"url":"https://{vanity}.symphony.com","description":"Symphony provided tenant URL","variables":{"vanity":{"description":"Customer ID assigned by the service provider","default":"yourpodURL"}}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"The File Management API uses **JWT (JSON Web Tokens)** for authentication.\n\n##### Obtaining a Token\nTo retrieve a valid token, you must call the `login/idm/tokens` endpoint.\n* **Requirements:** Use a **Service Account** that has been assigned the **Content Export Reader** role.\n* **Response:** The JWT will be returned in the `access_token` field of the JSON response.\n* **Reference:** For detailed steps on the handshake, see the **OAuth2 Authenticate** documentation.\n\n##### Using the Token\nOnce obtained, include the token in the `Authorization` header for all API requests:\n`Authorization: Bearer <access_token>`\n"}},"schemas":{"FileType":{"type":"string","description":"The type of file being managed.","enum":["ContentExport"]},"FileMetadata":{"required":["id","name","type"],"type":"object","properties":{"id":{"type":"string","description":"Unique file identifier."},"name":{"type":"string","description":"File name."},"size":{"type":"integer","description":"File size in bytes.","format":"int64"},"uploadTime":{"type":"string","description":"Timestamp of when the file was uploaded (ISO 8601 format).","format":"date-time"},"contentType":{"type":"string","description":"MIME type of the file."},"integrityHash":{"type":"string","description":"A cryptographic hash of the file content."},"type":{"type":"string","description":"The type of file."},"encryption":{"type":"object","properties":{"encryptionKeyId":{"type":"string","description":"An identifier for the key used to encrypt the file."},"alg":{"type":"string","description":"Encryption algorithm used."}},"description":"Encryption details for the file."}},"discriminator":{"propertyName":"type","mapping":{"ContentExport":"#/components/schemas/ContentExportFile"}}},"Error":{"type":"object","properties":{"error":{"type":"string","description":"A descriptive error message."}}}}},"paths":{"/files/v1/{fileId}/metadata":{"get":{"tags":["Files"],"summary":"Get File Metadata","description":"Retrieves all metadata of a specific file. This endpoint is subject to audit.","operationId":"getFileMetadata","parameters":[{"name":"fileId","in":"path","description":"The unique ID of the file.","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Mandatory query parameter to specify the file type. For Content Export files, use 'ContentExport'.","required":true,"style":"form","explode":true,"schema":{"$ref":"#/components/schemas/FileType"}}],"responses":{"200":{"description":"File metadata retrieved successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileMetadata"}}}},"401":{"description":"Unauthorized - Authentication failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden - Invalid entitlements.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found - File not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```