| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Get All Attachments from UW Task
Returns a list of all attachments uploaded to a specific underwriting task ticket. The response includes metadata for each file — such as the file name, document type, upload timestamp, and the user who uploaded it — without returning the actual file contents. To download file content, use GET /api/v1/uwTasks/ticket/getAttachmentById with the attachment ID from this response.
Endpoint
GET /api/v1/uwTasks/ticket/getAttachmentsByTicketId
Authentication
Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:
Authorization: Basic {base64(username:password)}
When to use
Use this endpoint to get an overview of all documents that have been submitted to a UW task ticket before deciding which specific file to download or review. This is the first step when auditing whether required documentation has been provided, or when presenting an attachment list in a merchant portal UI.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer (int32) | Yes | Merchant profile ID that owns the UW task |
| ticketId | integer (int32) | Yes | ID of the UW task ticket whose attachments to list |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| data | array | List of attachment metadata objects |
| data[].id | integer | Unique attachment ID (use with getAttachmentById) |
| data[].fileName | string | Name of the uploaded file |
| data[].dateTime | string (date-time) | ISO 8601 timestamp when the file was uploaded |
| data[].type | string | Document category (e.g., "DriversLicense") |
| data[].riskDocument | boolean | Whether this document is classified as a risk document |
| data[].userName | string | Username of the person who uploaded the file |
| status | string (enum) | HTTP status name, e.g., "OK" |
| error | string | Error message if the operation failed |
| warning | string | Non-fatal warning message |
| validationResults | array | Field-level validation errors, if any |
| requestId | integer | Unique identifier for this API request |
{
"data": [
{
"id": 5519,
"fileName": "john_smith_dl.pdf",
"dateTime": "2026-05-10T14:32:00Z",
"type": "DriversLicense",
"riskDocument": false,
"userName": "[email protected]"
},
{
"id": 5524,
"fileName": "business_bank_statement_apr2026.pdf",
"dateTime": "2026-05-12T09:15:00Z",
"type": "BusinessBankStatements",
"riskDocument": false,
"userName": "[email protected]"
}
],
"status": "OK",
"error": null,
"warning": null,
"validationResults": [],
"requestId": 88589
}Error Codes
| Code | When it happens |
|---|---|
| 400 | id or ticketId is missing or not a valid integer |
| 401 | Invalid or missing Basic Auth credentials |
| 403 | User does not have permission for this operation |
| 404 | Merchant or ticket not found |
| 500 | Internal server error |
Common Mistakes
- Expecting file binary content in this response — this endpoint returns metadata only; use
getAttachmentByIdfor file content. - Using a merchant profile ID that does not match the ticket — both
idandticketIdmust correspond to the same merchant.
Related Endpoints
GET /api/v1/uwTasks/ticket/getAttachmentById— download the content of a specific attachmentPOST /api/v1/uwTasks/ticket/addAttachment— upload a new attachment to the ticketGET /api/v1/uwTasks/getByMerchantId— get the list of UW task tickets for a merchant
Example
curl -X GET "https://hq.staging.netevia.dev/api/v1/uwTasks/ticket/getAttachmentsByTicketId?id=48201&ticketId=1073" \
-H "Authorization: Basic $(echo -n 'username:password' | base64)"