List asset assignment history

Returns every assignment of the path asset, newest first, with the contact name joined. An asset that does not exist in the authenticated tenant returns 404 rather than an empty array.

RBAC · asset

Path parameters

idstring <uuid>Required

Asset UUID from assets.asset_id.

Response body

Success response 200 · schema AssetAssignmentListResponse

dataarray of AssetAssignmentRequired

itemsobject

assignment_idstring <uuid>Required

asset_idstring <uuid>Required

contact_name_idstring <uuid>Required

contact_namestringNullable

Joined from contacts.full_name.

assigned_atstring <date-time>Required

assigned_by_user_idstring <uuid>Nullable

unassigned_atstring <date-time>Nullable

Null while this is the current assignment.

unassigned_by_user_idstring <uuid>Nullable

sourcestringRequired

Where the assignment came from.

Enum: manualapirmmbundleimportmergesystem

notestringNullable

For an rmm assignment, the raw signed-in user name.

Response codes

200

Assignment history returned successfully.

401

x-api-key is missing at middleware.

403

Caller lacks asset read permission.

404

Asset not found in this tenant.

500

Unexpected error.

GET /api/v1/assets/{id}/assignments

cURL

curl -X GET "https://algapsa.com/api/v1/assets/{id}/assignments" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/assets/{id}/assignments", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/v1/assets/{id}/assignments");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": [
    {
      "assignment_id": "01HN2K7VRB9PQ3Y0000000000",
      "asset_id": "01HN2K7VRB9PQ3Y0000000000",
      "contact_name_id": "01HN2K7VRB9PQ3Y0000000000",
      "contact_name": "string",
      "assigned_at": "2026-04-18T15:22:14Z",
      "assigned_by_user_id": "01HN2K7VRB9PQ3Y0000000000",
      "unassigned_at": "2026-04-18T15:22:14Z",
      "unassigned_by_user_id": "01HN2K7VRB9PQ3Y0000000000",
      "source": "manual",
      "note": "string"
    }
  ]
}