Get Legal Hold by ID
Retrieve details for a single active legal hold asset.
GET
/api/v1/legal-hold/{id}Description
Returns asset and hold metadata for a manage_app_assets record currently in Legal Hold status.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Pass the full value from the API response in path parameters. |
Response
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| message | string | Human-readable status message. |
| data | object | Legal hold asset details. |
| data.id | string | Opaque asset record ID. |
| data.asset_id | string | Internal asset identifier. |
| data.customer_asset_id | string | Customer asset ID. |
| data.placed_on | string | Date the hold was placed (formatted). |
| data.age_on_hold | string | Duration on hold (e.g. 3 Days). |
| data.serial_number | string | Device serial number. |
| data.asset_name | string | Product or model name. |
| data.manufacturer_name | string | Manufacturer name. |
| data.product_type_name | string | Product type (e.g. Laptop). |
| data.status_name | string | Current status name (Legal Hold). |
| data.status_type_name | string | Status type label (e.g. Undeployable). |
| data.status_type_id | number | Status type ID. |
| data.asset_location | string | Asset location name. |
| data.last_assignee | string | Last assigned employee name. |
| data.ticket_exists | boolean | Whether a related ticket exists. |
| data.ticket_info | object | null | Related ticket details when ticket_exists is true. |
Related Endpoints
Did this page help you?
Request
curl -X GET https://uat.unduit.com/api-exposed/api/v1/legal-hold/2748391-9001 \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"Success Response
{
"success": true,
"message": "Active legal hold retrieved successfully",
"data": {
"id": "2748391-9001",
"asset_id": "AST-1001",
"customer_asset_id": "IT-1234-ABCD",
"placed_on": "Jun 1, 2026",
"age_on_hold": "3 Days",
"serial_number": "C02XK1ABCDEF",
"asset_name": "MacBook Pro 14",
"manufacturer_name": "Apple",
"product_type_name": "Laptop",
"status_name": "Legal Hold",
"status_type_name": "Undeployable",
"status_type_id": 2,
"asset_location": "San Francisco Office",
"last_assignee": "John Doe",
"ticket_exists": false,
"ticket_info": null
}
}Error Responses
404 Not Found
{
"success": false,
"error": "Active legal hold not found"
}401 Unauthorized
{
"message": "Access denied: No token provided."
}