Skip to content

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_list on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • itemsobject[]required

    What you have now.

    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
  • returnedobject[]required

    What you had and gave back (or that moved to someone else), newest first.

    7 fields
    • idstringrequired
    • typestring (enum)required

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

    • namestringrequired
    • modelstring | nullrequired
    • serialstring | nullrequired
    • fromstringrequired
    • tostringrequired
  • waitingintegerrequired

    Items you have not confirmed yet.

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/assets/me.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
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": 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_confirm on My Workplace
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

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/me.confirm \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"asset_id":"as1"}'
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": 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.

Developer docs