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	number	Yes	manage_app_assets.id of the held device.

Response

Related Endpoints

View Active Holds

List all active holds

Submit Legal Hold

Place a new hold

Did this page help you?

Request

curl -X GET https://uat.unduit.com/api-exposed/api/v1/legal-hold/9001 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Success Response

{
  "success": true,
  "message": "Active legal hold retrieved successfully",
  "data": {
    "id": 9001,
    "asset_id": "AST-1001",
    "serial_number": "C02XK1ABCDEF",
    "asset_name": "MacBook Pro 14",
    "manufacturer_name": "Apple",
    "product_type_name": "Laptop",
    "status_name": "Legal Hold",
    "status_type_name": "Undeployable",
    "asset_location": "San Francisco Office",
    "last_assignee": "John Doe",
    "placed_on": "Jun 1st, 2026",
    "age_on_hold": "3 days",
    "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."
}