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

# Get Files

> Retrieve files

Retrieve a list of file attachments or get details for a specific file.

### Query Parameters

<ParamField query="id" type="number">
  Optional file ID to get a specific file
</ParamField>

<ParamField query="candidateId" type="number">
  Filter files by candidate ID
</ParamField>

<ParamField query="type" type="string">
  Filter files by type
</ParamField>

### Response

<ResponseField name="files" type="array">
  List of file objects
</ResponseField>

<RequestExample>
  ```bash theme={null}
  # Get all files for a candidate
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/file?candidateId=456 \
    --header 'Authorization: Bearer <token>'

  # Get specific file
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/file?id=999 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "files": [
      {
        "id": 999,
        "url": "https://storage.harmonyforstaffing.com/files/resume-123.pdf",
        "fileName": "resume-123.pdf",
        "contentType": "application/pdf",
        "size": 1048576,
        "candidateId": 456,
        "type": "resume",
        "description": "Updated resume March 2024",
        "createdAt": "2024-03-19T18:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>