Skip to content

API reference

Equipment register

Laptops, phones, badges and cars: list, add, hand over, take back, import, retire, and the report by team; devices synced from Jamf Pro, Microsoft Intune, Kandji and Workwize are flagged for review.

9 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.

List equipment#

POST/v1/assets/listRead

Lists equipment in the register (laptops, phones, monitors, badges, cars…), sorted by name. Owners, admins and HR see every item with its value, purchase date, tag, notes and, for devices synced from Jamf Pro, Microsoft Intune, Kandji or Workwize, the tool's user and review flag. Anyone else sees only the equipment held by them or by people who report to them (no value, notes or tool details). Filters: q (words in the name, model, serial or tag), type, status, person_id (what one person holds), team_id (held by people in a team today), source (manual or a tool id), review (only synced devices to look at: unmatched user, mismatch, missing from the tool).

Who can call it
Manage key any Manage role
Me key anyone
MCP tool
assets_list on HR Assistant, My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • qstring

    Up to 100 characters.

  • typestring (enum)

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • status"in_stock" | "assigned" | "in_repair" | "retired"
  • person_idstring

    1–100 characters.

  • team_idstring

    1–100 characters.

  • sourcestring

    manual, or jamf, intune, kandji, workwize.

    Up to 40 characters.

  • reviewboolean
  • limitinteger

    Default 1000.

    From 1 to 5000.

Returns

  • itemsobject[]required
    19 fields
    • idstringrequired
    • typestring (enum)required

      One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

    • namestringrequired
    • modelstring | nullrequired
    • serialstring | nullrequired
    • status"in_stock" | "assigned" | "in_repair" | "retired"required
    • holderobject | nullrequired

      Who has it now.

      2 fields
      • idstringrequired
      • namestringrequired
    • sincestring | nullrequired

      The day they got it.

    • confirmed_atstring | nullrequired

      When the holder confirmed they have it; null while waiting.

    • asset_tagstring | nullrequired
    • valuenumber | nullrequired
    • currencystring | nullrequired
    • purchase_datestring | nullrequired
    • notesstring | nullrequired
    • sourceobject | nullrequired

      A device read from a device management tool.

      9 fields
      • connectorstringrequired

        jamf, intune, kandji or workwize.

      • platformstring | nullrequired
      • os_versionstring | nullrequired
      • managedboolean | nullrequired
      • last_seen_atstring | nullrequired

        Last check-in with the tool.

      • console_urlstring | nullrequired

        The device in the tool (HR acts there: Bizisy never locks or wipes).

      • userobject | nullrequired

        Who the tool says uses it. HR only (null for others).

        2 fields
        • emailstring | nullrequired
        • namestring | nullrequired
      • match"matched" | "unmatched" | "none" | "mismatch"required

        matched (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.

      • missingbooleanrequired

        Not in the tool any more since the last sync.

    • review"unmatched" | "mismatch" | "missing"required

      What HR should look at for a synced device (HR only).

    • access"full" | "holder"required

      holder: the person or their manager: no value, purchase date, tag, notes or tool details.

    • created_atstringrequired
    • updated_atstringrequired
  • totalintegerrequired

    Matching items before the limit.

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "q": "macbook",
  "type": "laptop",
  "status": "assigned",
  "person_id": "p1",
  "team_id": "u1",
  "source": "jamf",
  "review": true,
  "limit": 50
}'
Response
{
  "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": "IT-0042",
        "value": 2399,
        "currency": "EUR",
        "purchase_date": "2025-12-20",
        "notes": "Bought with the Lisbon budget",
        "source": {
          "connector": "jamf",
          "platform": "macOS",
          "os_version": "15.1",
          "managed": true,
          "last_seen_at": "2026-10-04T08:00:00.000Z",
          "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
          "user": {
            "email": "ana@acme.test",
            "name": "Ana Ferreira"
          },
          "match": "matched",
          "missing": false
        },
        "review": null,
        "access": "full",
        "created_at": "2026-01-05T10:00:00.000Z",
        "updated_at": "2026-10-04T08:00:00.000Z"
      }
    ],
    "total": 1
  }
}

Get equipment#

POST/v1/assets/getRead

One item and, for owners, admins and HR, its dated history (who had it, from, to, and how it came back). The holder and their managers see the item without value, notes, tool details or history.

Who can call it
Manage key any Manage role
Me key anyone
MCP tool
assets_get on HR Assistant, My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • asset_idstringrequired

    1–100 characters.

Returns

  • itemobjectrequired
    19 fields
    • idstringrequired
    • typestring (enum)required

      One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

    • namestringrequired
    • modelstring | nullrequired
    • serialstring | nullrequired
    • status"in_stock" | "assigned" | "in_repair" | "retired"required
    • holderobject | nullrequired

      Who has it now.

      2 fields
      • idstringrequired
      • namestringrequired
    • sincestring | nullrequired

      The day they got it.

    • confirmed_atstring | nullrequired

      When the holder confirmed they have it; null while waiting.

    • asset_tagstring | nullrequired
    • valuenumber | nullrequired
    • currencystring | nullrequired
    • purchase_datestring | nullrequired
    • notesstring | nullrequired
    • sourceobject | nullrequired

      A device read from a device management tool.

      9 fields
      • connectorstringrequired

        jamf, intune, kandji or workwize.

      • platformstring | nullrequired
      • os_versionstring | nullrequired
      • managedboolean | nullrequired
      • last_seen_atstring | nullrequired

        Last check-in with the tool.

      • console_urlstring | nullrequired

        The device in the tool (HR acts there: Bizisy never locks or wipes).

      • userobject | nullrequired

        Who the tool says uses it. HR only (null for others).

        2 fields
        • emailstring | nullrequired
        • namestring | nullrequired
      • match"matched" | "unmatched" | "none" | "mismatch"required

        matched (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.

      • missingbooleanrequired

        Not in the tool any more since the last sync.

    • review"unmatched" | "mismatch" | "missing"required

      What HR should look at for a synced device (HR only).

    • access"full" | "holder"required

      holder: the person or their manager: no value, purchase date, tag, notes or tool details.

    • created_atstringrequired
    • updated_atstringrequired
  • historyobject[]required
    6 fields
    • idstringrequired
    • personobject | nullrequired

      null: the person was erased.

      2 fields
      • idstringrequired
      • namestringrequired
    • fromstringrequired
    • tostring | nullrequired
    • returnedobject | nullrequired
      2 fields
      • condition"ok" | "damaged" | "lost"required
      • notestring | nullrequired
    • by"hr" | "sync"required

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_id":"as1"}'
Response
{
  "data": {
    "item": {
      "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": "IT-0042",
      "value": 2399,
      "currency": "EUR",
      "purchase_date": "2025-12-20",
      "notes": "Bought with the Lisbon budget",
      "source": {
        "connector": "jamf",
        "platform": "macOS",
        "os_version": "15.1",
        "managed": true,
        "last_seen_at": "2026-10-04T08:00:00.000Z",
        "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
        "user": {
          "email": "ana@acme.test",
          "name": "Ana Ferreira"
        },
        "match": "matched",
        "missing": false
      },
      "review": null,
      "access": "full",
      "created_at": "2026-01-05T10:00:00.000Z",
      "updated_at": "2026-10-04T08:00:00.000Z"
    },
    "history": [
      {
        "id": "h1",
        "person": {
          "id": "p1",
          "name": "Ana Ferreira"
        },
        "from": "2026-01-05",
        "to": null,
        "returned": null,
        "by": "hr"
      }
    ]
  }
}

Add equipment#

POST/v1/assets/createWrite

Adds an item to the equipment register: type, name, and optionally model, serial (unique in the company), asset_tag, value with currency, purchase_date and notes. status in_stock (default), in_repair or retired; or assign_to {person_id, since} to hand it to someone at once (employed or about to start; since defaults to today, at most 30 days ahead). A company holds up to 5000 items. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_create on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • typestring (enum)required

    laptop, desktop, phone, tablet, monitor, badge, car or other.

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestringrequired

    What people call it, e.g. "MacBook Pro 14" or "Office badge".

    1–120 characters.

  • modelstring | null

    Up to 120 characters.

  • serialstring | null

    Unique in the company (compared without spaces or dashes, case-insensitive).

    Up to 80 characters.

  • asset_tagstring | null

    Your own inventory number or label.

    Up to 60 characters.

  • valuenumber | null

    Purchase value, in currency (two decimals). HR only.

    From 0 to 10000000.

  • currencystring | null

    ISO 4217 code; required with a value.

    Pattern ^[A-Za-z]{3}$.

  • purchase_datestring | null

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • notesstring | null

    HR only; never shown to the person or their managers.

    Up to 1000 characters.

  • status"in_stock" | "in_repair" | "retired"
  • assign_toobject
    2 fields
    • person_idstringrequired

      1–100 characters.

    • sincestring

      Pattern ^\d{4}-\d{2}-\d{2}$.

Returns

19 fields
  • idstringrequired
  • typestring (enum)required

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestringrequired
  • modelstring | nullrequired
  • serialstring | nullrequired
  • status"in_stock" | "assigned" | "in_repair" | "retired"required
  • holderobject | nullrequired

    Who has it now.

    2 fields
    • idstringrequired
    • namestringrequired
  • sincestring | nullrequired

    The day they got it.

  • confirmed_atstring | nullrequired

    When the holder confirmed they have it; null while waiting.

  • asset_tagstring | nullrequired
  • valuenumber | nullrequired
  • currencystring | nullrequired
  • purchase_datestring | nullrequired
  • notesstring | nullrequired
  • sourceobject | nullrequired

    A device read from a device management tool.

    9 fields
    • connectorstringrequired

      jamf, intune, kandji or workwize.

    • platformstring | nullrequired
    • os_versionstring | nullrequired
    • managedboolean | nullrequired
    • last_seen_atstring | nullrequired

      Last check-in with the tool.

    • console_urlstring | nullrequired

      The device in the tool (HR acts there: Bizisy never locks or wipes).

    • userobject | nullrequired

      Who the tool says uses it. HR only (null for others).

      2 fields
      • emailstring | nullrequired
      • namestring | nullrequired
    • match"matched" | "unmatched" | "none" | "mismatch"required

      matched (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.

    • missingbooleanrequired

      Not in the tool any more since the last sync.

  • review"unmatched" | "mismatch" | "missing"required

    What HR should look at for a synced device (HR only).

  • access"full" | "holder"required

    holder: the person or their manager: no value, purchase date, tag, notes or tool details.

  • created_atstringrequired
  • updated_atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/create \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "type": "laptop",
  "name": "MacBook Pro 14",
  "model": "MacBookPro18,3",
  "serial": "C02XY123",
  "asset_tag": "IT-0042",
  "value": 2399,
  "currency": "EUR",
  "purchase_date": "2025-12-20",
  "notes": null,
  "assign_to": {
    "person_id": "p1",
    "since": "2026-01-05"
  }
}'
Response
{
  "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": "IT-0042",
    "value": 2399,
    "currency": "EUR",
    "purchase_date": "2025-12-20",
    "notes": null,
    "source": {
      "connector": "jamf",
      "platform": "macOS",
      "os_version": "15.1",
      "managed": true,
      "last_seen_at": "2026-10-04T08:00:00.000Z",
      "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
      "user": {
        "email": "ana@acme.test",
        "name": "Ana Ferreira"
      },
      "match": "matched",
      "missing": false
    },
    "review": null,
    "access": "full",
    "created_at": "2026-01-05T10:00:00.000Z",
    "updated_at": "2026-10-04T08:00:00.000Z"
  }
}

Change equipment#

POST/v1/assets/updateWrite

Changes an item's details (type, name, model, serial, asset_tag, value, currency, purchase_date, notes; null clears), or its status: in_stock, in_repair or retired (equipment someone holds is returned with assets_return first). keep_holder: true on a synced device flagged mismatch or unmatched keeps Bizisy's holder (or no holder) although the tool names another user; the flag comes back only when the tool's user changes. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_update on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • typestring (enum)

    laptop, desktop, phone, tablet, monitor, badge, car or other.

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestring

    What people call it, e.g. "MacBook Pro 14" or "Office badge".

    1–120 characters.

  • modelstring | null

    Up to 120 characters.

  • serialstring | null

    Unique in the company (compared without spaces or dashes, case-insensitive).

    Up to 80 characters.

  • asset_tagstring | null

    Your own inventory number or label.

    Up to 60 characters.

  • valuenumber | null

    Purchase value, in currency (two decimals). HR only.

    From 0 to 10000000.

  • currencystring | null

    ISO 4217 code; required with a value.

    Pattern ^[A-Za-z]{3}$.

  • purchase_datestring | null

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • notesstring | null

    HR only; never shown to the person or their managers.

    Up to 1000 characters.

  • asset_idstringrequired

    1–100 characters.

  • status"in_stock" | "in_repair" | "retired"
  • keep_holdertrue

Returns

19 fields
  • idstringrequired
  • typestring (enum)required

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestringrequired
  • modelstring | nullrequired
  • serialstring | nullrequired
  • status"in_stock" | "assigned" | "in_repair" | "retired"required
  • holderobject | nullrequired

    Who has it now.

    2 fields
    • idstringrequired
    • namestringrequired
  • sincestring | nullrequired

    The day they got it.

  • confirmed_atstring | nullrequired

    When the holder confirmed they have it; null while waiting.

  • asset_tagstring | nullrequired
  • valuenumber | nullrequired
  • currencystring | nullrequired
  • purchase_datestring | nullrequired
  • notesstring | nullrequired
  • sourceobject | nullrequired

    A device read from a device management tool.

    9 fields
    • connectorstringrequired

      jamf, intune, kandji or workwize.

    • platformstring | nullrequired
    • os_versionstring | nullrequired
    • managedboolean | nullrequired
    • last_seen_atstring | nullrequired

      Last check-in with the tool.

    • console_urlstring | nullrequired

      The device in the tool (HR acts there: Bizisy never locks or wipes).

    • userobject | nullrequired

      Who the tool says uses it. HR only (null for others).

      2 fields
      • emailstring | nullrequired
      • namestring | nullrequired
    • match"matched" | "unmatched" | "none" | "mismatch"required

      matched (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.

    • missingbooleanrequired

      Not in the tool any more since the last sync.

  • review"unmatched" | "mismatch" | "missing"required

    What HR should look at for a synced device (HR only).

  • access"full" | "holder"required

    holder: the person or their manager: no value, purchase date, tag, notes or tool details.

  • created_atstringrequired
  • updated_atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/update \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"asset_id":"as1","name":"MacBook Pro 14 (2023)"}'
Response
{
  "data": {
    "id": "as1",
    "type": "laptop",
    "name": "MacBook Pro 14 (2023)",
    "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": "IT-0042",
    "value": 2399,
    "currency": "EUR",
    "purchase_date": "2025-12-20",
    "notes": "Bought with the Lisbon budget",
    "source": {
      "connector": "jamf",
      "platform": "macOS",
      "os_version": "15.1",
      "managed": true,
      "last_seen_at": "2026-10-04T08:00:00.000Z",
      "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
      "user": {
        "email": "ana@acme.test",
        "name": "Ana Ferreira"
      },
      "match": "matched",
      "missing": false
    },
    "review": null,
    "access": "full",
    "created_at": "2026-01-05T10:00:00.000Z",
    "updated_at": "2026-10-04T08:00:00.000Z"
  }
}

Assign equipment#

POST/v1/assets/assignWrite

Hands an item to a person (employed or about to start) on a day (since, default today, at most 30 days ahead). An item someone else holds moves to the new person: the previous holder's history row closes that day. The person sees it in My equipment and confirms they have it. Retired items can't be assigned. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_assign on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • asset_idstringrequired

    1–100 characters.

  • person_idstringrequired

    1–100 characters.

  • sincestring

    Pattern ^\d{4}-\d{2}-\d{2}$.

Returns

19 fields
  • idstringrequired
  • typestring (enum)required

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestringrequired
  • modelstring | nullrequired
  • serialstring | nullrequired
  • status"in_stock" | "assigned" | "in_repair" | "retired"required
  • holderobject | nullrequired

    Who has it now.

    2 fields
    • idstringrequired
    • namestringrequired
  • sincestring | nullrequired

    The day they got it.

  • confirmed_atstring | nullrequired

    When the holder confirmed they have it; null while waiting.

  • asset_tagstring | nullrequired
  • valuenumber | nullrequired
  • currencystring | nullrequired
  • purchase_datestring | nullrequired
  • notesstring | nullrequired
  • sourceobject | nullrequired

    A device read from a device management tool.

    9 fields
    • connectorstringrequired

      jamf, intune, kandji or workwize.

    • platformstring | nullrequired
    • os_versionstring | nullrequired
    • managedboolean | nullrequired
    • last_seen_atstring | nullrequired

      Last check-in with the tool.

    • console_urlstring | nullrequired

      The device in the tool (HR acts there: Bizisy never locks or wipes).

    • userobject | nullrequired

      Who the tool says uses it. HR only (null for others).

      2 fields
      • emailstring | nullrequired
      • namestring | nullrequired
    • match"matched" | "unmatched" | "none" | "mismatch"required

      matched (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.

    • missingbooleanrequired

      Not in the tool any more since the last sync.

  • review"unmatched" | "mismatch" | "missing"required

    What HR should look at for a synced device (HR only).

  • access"full" | "holder"required

    holder: the person or their manager: no value, purchase date, tag, notes or tool details.

  • created_atstringrequired
  • updated_atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/assign \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"asset_id":"as1","person_id":"p1","since":"2026-10-01"}'
Response
{
  "data": {
    "id": "as1",
    "type": "laptop",
    "name": "MacBook Pro 14",
    "model": "MacBookPro18,3",
    "serial": "C02XY123",
    "status": "assigned",
    "holder": {
      "id": "p1",
      "name": "Ana Ferreira"
    },
    "since": "2026-10-01",
    "confirmed_at": "2026-01-05T10:00:00.000Z",
    "asset_tag": "IT-0042",
    "value": 2399,
    "currency": "EUR",
    "purchase_date": "2025-12-20",
    "notes": "Bought with the Lisbon budget",
    "source": {
      "connector": "jamf",
      "platform": "macOS",
      "os_version": "15.1",
      "managed": true,
      "last_seen_at": "2026-10-04T08:00:00.000Z",
      "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
      "user": {
        "email": "ana@acme.test",
        "name": "Ana Ferreira"
      },
      "match": "matched",
      "missing": false
    },
    "review": null,
    "access": "full",
    "created_at": "2026-01-05T10:00:00.000Z",
    "updated_at": "2026-10-04T08:00:00.000Z"
  }
}

Take equipment back#

POST/v1/assets/returnWrite

Records that the holder gave an item back on a day (on, default today; not before they got it) and its condition: ok (back in stock, default), damaged (in repair) or lost (retired), with an optional note. An open offboarding task "Collect equipment" ticks itself once they hold nothing. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_return on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • asset_idstringrequired

    1–100 characters.

  • onstring

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • condition"ok" | "damaged" | "lost"
  • notestring | null

    Up to 500 characters.

Returns

20 fields
  • idstringrequired
  • typestring (enum)required

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • namestringrequired
  • modelstring | nullrequired
  • serialstring | nullrequired
  • status"in_stock" | "assigned" | "in_repair" | "retired"required
  • holderobject | nullrequired

    Who has it now.

    2 fields
    • idstringrequired
    • namestringrequired
  • sincestring | nullrequired

    The day they got it.

  • confirmed_atstring | nullrequired

    When the holder confirmed they have it; null while waiting.

  • asset_tagstring | nullrequired
  • valuenumber | nullrequired
  • currencystring | nullrequired
  • purchase_datestring | nullrequired
  • notesstring | nullrequired
  • sourceobject | nullrequired

    A device read from a device management tool.

    9 fields
    • connectorstringrequired

      jamf, intune, kandji or workwize.

    • platformstring | nullrequired
    • os_versionstring | nullrequired
    • managedboolean | nullrequired
    • last_seen_atstring | nullrequired

      Last check-in with the tool.

    • console_urlstring | nullrequired

      The device in the tool (HR acts there: Bizisy never locks or wipes).

    • userobject | nullrequired

      Who the tool says uses it. HR only (null for others).

      2 fields
      • emailstring | nullrequired
      • namestring | nullrequired
    • match"matched" | "unmatched" | "none" | "mismatch"required

      matched (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.

    • missingbooleanrequired

      Not in the tool any more since the last sync.

  • review"unmatched" | "mismatch" | "missing"required

    What HR should look at for a synced device (HR only).

  • access"full" | "holder"required

    holder: the person or their manager: no value, purchase date, tag, notes or tool details.

  • created_atstringrequired
  • updated_atstringrequired
  • returned_byobjectrequired
    1 field
    • idstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/return \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "asset_id": "as1",
  "on": "2026-10-04",
  "condition": "damaged",
  "note": "Cracked screen"
}'
Response
{
  "data": {
    "id": "as1",
    "type": "laptop",
    "name": "MacBook Pro 14",
    "model": "MacBookPro18,3",
    "serial": "C02XY123",
    "status": "in_stock",
    "holder": null,
    "since": null,
    "confirmed_at": null,
    "asset_tag": "IT-0042",
    "value": 2399,
    "currency": "EUR",
    "purchase_date": "2025-12-20",
    "notes": "Bought with the Lisbon budget",
    "source": {
      "connector": "jamf",
      "platform": "macOS",
      "os_version": "15.1",
      "managed": true,
      "last_seen_at": "2026-10-04T08:00:00.000Z",
      "console_url": "https://acme.jamfcloud.com/computers.html?id=7",
      "user": {
        "email": "ana@acme.test",
        "name": "Ana Ferreira"
      },
      "match": "matched",
      "missing": false
    },
    "review": null,
    "access": "full",
    "created_at": "2026-01-05T10:00:00.000Z",
    "updated_at": "2026-10-04T08:00:00.000Z",
    "returned_by": {
      "id": "p1"
    }
  }
}

Delete equipment#

POST/v1/assets/deleteDestructive

Deletes an item entered by mistake, with its history. Synced devices can't be deleted (the next sync would bring them back): retire them instead. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_delete on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • asset_idstringrequired

    1–100 characters.

Returns

  • idstringrequired
  • deletedtruerequired
  • typestring (enum)required

    One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

  • holder_idstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/delete \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"asset_id":"as1"}'
Response
{
  "data": {
    "id": "as1",
    "deleted": true,
    "type": "laptop",
    "holder_id": null
  }
}

Import equipment#

POST/v1/assets/importWrite

Adds up to 150 items at once (from a spreadsheet: one row each). Columns: type, name, model, serial, asset_tag, value, currency, purchase_date (YYYY-MM-DD), status, assigned_to (a work email), assigned_since, notes. All or nothing: run it as a dry run first to see each row's outcome; the real run refuses if any row has a problem (a duplicate serial, an unknown type or email, a value without currency, a date in the wrong format). Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_import on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity

Input

  • rowsobject[]required

    1–150 items.

    12 fields
    • typestringrequired

      laptop, phone, tablet, monitor, badge, car or other (case-insensitive).

      Up to 40 characters.

    • namestringrequired

      Up to 200 characters.

    • modelstring | null

      Up to 200 characters.

    • serialstring | null

      Up to 200 characters.

    • asset_tagstring | null

      Up to 200 characters.

    • valuenumber | string

      A number; a comma as decimal separator is accepted.

    • currencystring | null

      Up to 10 characters.

    • purchase_datestring | null

      Up to 40 characters.

    • statusstring | null

      in_stock (default), in_repair or retired; ignored when assigned_to is set.

      Up to 40 characters.

    • assigned_tostring | null

      The work email of the person who has it.

      Up to 320 characters.

    • assigned_sincestring | null

      Up to 40 characters.

    • notesstring | null

      Up to 2000 characters.

Returns

  • createdintegerrequired
  • assignedintegerrequired
  • rowsobject[]required
    4 fields
    • rowintegerrequired

      1 = the first data row.

    • okbooleanrequired
    • problemstring | nullrequired
    • asset_idstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/import \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "rows": [
    {
      "type": "laptop",
      "name": "ThinkPad X1",
      "serial": "PF-1",
      "value": "1299,50",
      "currency": "EUR",
      "assigned_to": "ana@acme.test",
      "assigned_since": "2026-09-01"
    }
  ]
}'
Response
{
  "data": {
    "created": 1,
    "assigned": 1,
    "rows": [
      {
        "row": 1,
        "ok": true,
        "problem": null,
        "asset_id": "as2"
      }
    ]
  }
}

Equipment by team#

POST/v1/assets/reportRead

How much equipment the company has and where: totals by status, values summed per currency, and per team (the holder's team today) the people holding equipment, the items and their value, and counts by type. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
assets_report on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • as_ofstringrequired
  • totalsobjectrequired
    6 fields
    • itemsintegerrequired
    • assignedintegerrequired
    • in_stockintegerrequired
    • in_repairintegerrequired
    • retiredintegerrequired
    • to_reviewintegerrequired
  • valuesobject[]required

    Sums of value per currency (items without a value are not counted).

    3 fields
    • currencystringrequired
    • totalnumberrequired
    • assignednumberrequired
  • teamsobject[]required
    5 fields
    • teamobject | nullrequired

      null: people with no team.

      2 fields
      • idstringrequired
      • namestringrequired
    • peopleintegerrequired

      People in the team holding equipment.

    • itemsintegerrequired
    • valuesobject[]required
      2 fields
      • currencystringrequired
      • totalnumberrequired
    • by_typeobject[]required
      2 fields
      • typestring (enum)required

        One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

      • countintegerrequired
  • typesobject[]required
    3 fields
    • typestring (enum)required

      One of: laptop, desktop, phone, tablet, monitor, badge, car, other.

    • totalintegerrequired
    • assignedintegerrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/report \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "data": {
    "as_of": "2026-10-04",
    "totals": {
      "items": 3,
      "assigned": 2,
      "in_stock": 1,
      "in_repair": 0,
      "retired": 0,
      "to_review": 1
    },
    "values": [
      {
        "currency": "EUR",
        "total": 3200,
        "assigned": 2900
      }
    ],
    "teams": [
      {
        "team": {
          "id": "u1",
          "name": "Engineering"
        },
        "people": 1,
        "items": 2,
        "values": [
          {
            "currency": "EUR",
            "total": 2900
          }
        ],
        "by_type": [
          {
            "type": "laptop",
            "count": 1
          },
          {
            "type": "phone",
            "count": 1
          }
        ]
      }
    ],
    "types": [
      {
        "type": "laptop",
        "total": 1,
        "assigned": 1
      },
      {
        "type": "phone",
        "total": 1,
        "assigned": 1
      },
      {
        "type": "monitor",
        "total": 1,
        "assigned": 0
      }
    ]
  }
}

Something missing or wrong on this page? Write to hello@bizisy.com.

Developer docs