API reference
My equipment
A person's own equipment and confirming they received it (Me keys).
2 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
My equipment#
POST/v1/assets/me.listRead
The equipment you have (laptop, phone, badge…) with the day you got it and whether you confirmed you have it, and what you had before. Never the value or HR's notes. Confirm an item with assets_me_confirm.
- Who can call it
- Me key anyone
- MCP tool
assets_me_liston My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
itemsobject[]requiredWhat you have now.
19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
returnedobject[]requiredWhat you had and gave back (or that moved to someone else), newest first.
7 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredfromstringrequiredtostringrequired
waitingintegerrequiredItems you have not confirmed yet.
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/me.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/assets/me.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/assets/me.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": null,
"value": null,
"currency": null,
"purchase_date": null,
"notes": null,
"source": null,
"review": null,
"access": "holder",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
],
"returned": [],
"waiting": 0
}
}Confirm I have equipment#
POST/v1/assets/me.confirmWrite
Confirms you received an item HR assigned to you (only your own; nobody can confirm for you). Confirming again changes nothing.
- Who can call it
- Me key anyone
- MCP tool
assets_me_confirmon My Workplace- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
asset_idstringrequired1–100 characters.
Returns
19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/me.confirm \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"asset_id":"as1"}'const res = await fetch('https://api.bizisy.com/v1/assets/me.confirm', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"asset_id": "as1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/assets/me.confirm",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"asset_id": "as1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": null,
"value": null,
"currency": null,
"purchase_date": null,
"notes": null,
"source": null,
"review": null,
"access": "holder",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
}Something missing or wrong on this page? Write to hello@bizisy.com.