Authentication
Every request must include your API key in the x-api-key header. Find your key in ComTrack under Integrations → API Keys.
Request
| Header | Type | Required | Description |
|---|
x-api-key | string | Yes | Your API key for authentication |
Content-Type | multipart/form-data | Yes | Set automatically when sending form data |
Body (multipart/form-data)
| Field | Type | Required | Description |
|---|
file | File (binary) | Yes | The file to upload. Accepted types: .pdf, .csv, .xlsx, .txt |
Response
200 OK: example successful response.
{
"status": "digested",
"file": {
"id": "9c681f6b-d3fd-418c-b347-8c8ba6878146",
"name": "filename123.xlsx"
}
}
| Field | Type | Description |
|---|
status | string | Processing result: digested, skipped_duplicate, not_recognized or rejected |
file.id | string (UUID) | Unique ID of the uploaded file. Use it to reference the file in other calls. |
file.name | string | The original filename uploaded |
Errors
| Code | Error | Description |
|---|
400 | Bad Request | Missing file field or invalid multipart structure |
401 | Unauthorized | Invalid or missing x-api-key |
413 | Payload Too Large | File exceeds the maximum allowed size |
415 | Unsupported Media Type | File type not supported |
422 | Unprocessable Entity | File unreadable, corrupted or password-protected |
429 | Too Many Requests | Rate limit exceeded |
500 / 503 | Server Error | Temporary or internal failure; retry later |
Examples
