Transfer histories

Asset transfer history details, which capture the transfer date and dimension details after an asset transfer operation is performed. For more information see Transfer an asset.

List transfer histories

get/objects/fixed-assets/transfer-history

Returns a collection with a key, ID, and link for each transfer operation. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "id": "1",
      • "key": "1",
      • "href": "/objects/fixed-assets/transfer-history/1"
      },
    • {
      • "id": "2",
      • "key": "2",
      • "href": "/objects/fixed-assets/transfer-history/2"
      }
    ],
  • "ia::meta": {
    • "totalCount": 2,
    • "totalSuccess": 2,
    • "totalError": 0
    }
}
Get a transfer history
get/objects/fixed-assets/transfer-history/{key}
Returns detailed information for a specified transfer history.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the transfer history.


 
 Example:  1
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "asset": {
      • "name": "Laptop",
      • "id": "ADJDEC0207",
      • "key": "2140"
      },
    • "journalEntries": [
      • {
        },
      • {
        }
      ],
    • "audit": {
      • "createdBy": "1",
      • "createdDateTime": "2024-11-19T18:41:01Z",
      • "modifiedBy": "1",
      • "modifiedDateTime": "2024-11-19T18:41:01Z",
      • "createdByUser": {
        },
      • "modifiedByUser": {
        }
      },
    • "dimensions": {
      • "item": {
        },
      • "location": {
        },
      • "department": {
        },
      • "customer": {
        }
      },
    • "id": "3",
    • "transferDate": "2024-11-15",
    • "key": "3"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete a transfer history
delete/objects/fixed-assets/transfer-history/{key}
Deletes a transfer history.


You can delete latest transfer history of an asset.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the transfer history.


 
 Example:  1
Responses 
204
No Content


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}