Introduction

This guide will help you get started with the BlueTally API! All the important stuff is documented here, but should you have any questions, always feel free to reach out to [email protected].


Authentication

You will need to create an API key that is associated with your account in order to use the API.

Start by clicking the profile icon in the top right corner and click on "Settings".

BlueTally API Documentation

Then click on "API Keys" in the left navigation bar.

BlueTally API Documentation

Now click on "Create API Key". This is the key you'll use as a Bearer token when interacting with the API, so please keep this key safe.

BlueTally API Documentation

Connecting to the API

Now that you have your API key, you can connect to the API using any client, such as Postman. The base link of the API is:
https://app.bluetallyapp.com/api/v1

Make sure you use your API key as a Bearer type token for authenticating with the API.

There is a rate limit of 600 API requests per hour (10/min), and a limit of 500 results per query.


Accessories

GET '/accessories' - Returns all accessories.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, model_number, order_number, purchase_date, purchase_cost, minimum_quantity, quantity, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • model_number (String) Exact search for model number.

  • order_number (String) Exact search for order number.

  • purchase_date (String) Exact search for purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Exact search for purchase price.

  • minimum_quantity (Integer) Exact search for minimum quantity.

  • quantity (Integer) Exact search for quantity.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Exact search for manufacturer id.

  • supplier_id (Integer) Exact search for supplier id.

  • location_id (Integer) Exact search for location id.

  • department_id (Integer) Exact search for department id.

  • qr_code (Boolean) Exact search for qr code.

  • notes (String) Exact search for notes.


GET '/accessories/:id' - Returns a specific accessory.

Parameters

  • id (Integer, required) The ID of the accessory.


POST '/accessories' - Create an accessory.

Parameters

  • name (String, required) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer, required) Quantity.

  • category_id (Integer, required) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • qr_code (Boolean) QR code.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/accessories/:id' - Update an accessory.

Parameters

  • id (Integer, required) The ID of the accessory.

  • name (String) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer) Quantity.

  • category_id (Integer) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • qr_code (Boolean) QR code.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/accessories/:id' - Delete an accessory.

Parameters

  • id (Integer, required) The ID of the accessory.

Assets

GET '/assets' - Returns all assets.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is asset_id.
    Options: { created_at, updated_at, asset_id, asset_name, asset_serial, warranty_expiration_date, order_number, purchase_date, purchase_cost, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • asset_id (String) Exact search for asset id.

  • asset_name (String) Exact search for asset name

  • asset_serial (String) Exact search for asset serial.

  • warranty_expiration_date (String) Exact search for warranty expiration date. Format: '2022-12-01'

  • order_number (String) Exact search for order number.

  • purchase_date (String) Exact search for purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Exact search for purchase cost.

  • employee_email (String) Exact search for all assets checked out to an employee via email.

  • product_id (Integer) Exact search for product id.

  • category_id (Integer) Exact search for assets using products belonging to this category.

  • status_id (Integer) Exact search for status id.

  • supplier_id (Integer) Exact search for supplier id.

  • location_id (Integer) Exact search for location id.

  • department_id (Integer) Exact search for department id.

  • notes (String) Exact search for notes.


GET '/assets/:id' - Returns a specific asset.

Parameters

  • id (Integer, required) The ID of the asset.


POST '/assets' - Create an asset.

Parameters

  • asset_id (String, required) Asset id.

  • asset_name (String) Asset name

  • asset_serial (String) Asset serial.

  • warranty_expiration_date (String) Warranty expiration date. Format: '2022-12-01'

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase cost.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • product_id (Integer, required) Product id.

  • status_id (Integer, required) Status id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/assets/:id' - Update an asset.

Parameters

  • id (Integer) The unique ID of the asset.

  • asset_id (String) Asset id.

  • asset_name (String) Asset name

  • asset_serial (String) Asset serial.

  • warranty_expiration_date (String) Warranty expiration date. Format: '2022-12-01'

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase cost.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • product_id (Integer) Product id.

  • status_id (Integer) Status id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/assets/:id' - Delete an asset.

Parameters

  • id (Integer, required) The ID of the asset.

Audits

GET '/audits' - Returns all audits.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is audit_date.
    Options: { created_at, updated_at, audit_date, next_audit_date, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • audit_date (String) Exact search for audit date. Format: '2022-12-01'

  • next_audit_date (String) Exact search for next audit date. Format: '2022-12-01'

  • scheduled (Boolean) Exact search for scheduled audits.

  • completed (Boolean) Exact search for completed audits.

  • asset_id (String) Exact search for asset id.

  • location_id (Integer) Exact search for location id.

  • user_id (Integer) Exact search for user id.

  • notes (String) Exact search for notes.


GET '/audits/:id' - Returns a specific audit.

Parameters

  • id (Integer, required) The ID of the audit.


POST '/audits' - Create an audit.

Parameters

  • audit_date (String, required) Audit date. Format: '2022-12-01'

  • next_audit_date (String) Audit date. Format: '2022-12-01'

  • scheduled (Boolean, required) If audit is scheduled.

  • completed (Boolean, required) If audit is completed.

  • asset_id (String, required) The id of the asset that was audited.

  • location_id (Integer) Location id.

  • user_id (Integer, required) The id of the user who performed the audit.

  • notes (String) Notes.


PUT '/audits/:id' - Update an audit.

Parameters

  • id (Integer, required) The ID of the audit.

  • audit_date (String) Audit date. Format: '2022-12-01'

  • next_audit_date (String) Audit date. Format: '2022-12-01'

  • scheduled (Boolean) If audit is scheduled.

  • completed (Boolean) If audit is completed.

  • asset_id (String) The id of the asset that was audited.

  • location_id (Integer) Location id.

  • user_id (Integer) The id of the user who performed the audit.

  • notes (String) Notes.


DELETE '/audits/:id' - Delete an audit.

Parameters

  • id (Integer, required) The ID of the audit.

Categories

GET '/categories' - Returns all categories.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, type }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • type (String) Exact search for type. Options: { accessory, asset, consumable, component, license }

  • checkout_email (Boolean) Exact search for if checkout emails are enabled.


GET '/categories/:id' - Returns a specific category.

Parameters

  • id (Integer, required) The ID of the category.


POST '/categories' - Create a category.

Parameters

  • name (String, required) Name.

  • type (String, required) Type. Options: { accessory, asset, consumable, component, license }

  • checkout_email (Boolean) Exact search for if checkout emails are enabled.

  • eula (String) End User License Agreement.

  • logo (String) External URL to logo.


PUT '/categories/:id' - Update a category.

Parameters

  • id (Integer, required) The ID of the category.

  • name (String) Name.

  • type (String) Type. Options: { accessory, asset, consumable, component, license }

  • checkout_email (Boolean) Exact search for if checkout emails are enabled.

  • eula (String) End User License Agreement.

  • logo (String) External URL to logo.


DELETE '/categories/:id' - Delete a category.

Parameters

  • id (Integer, required) The ID of the category.

Checkin

POST '/checkin/asset' - Checkin an asset.

Parameters

  • asset_id (String, required) Asset ID

  • checkin_date (String, required) Checkin date. Format: '2022-12-01'

  • status_id (Integer, required) Status ID

  • condition (Integer) Condition

  • notes (String) Notes.

  • asset_location_id (Integer) ID of the location you'd like the asset to belong to.

  • asset_department_id (Integer) ID of the department you'd like the asset to belong to.


POST '/checkin/accessory' - Checkin an accessory.

Parameters

  • accessory_id (Integer, required) Accessory ID.

  • employee_id (Integer) ID of the employee you'd like to check the accessory in from.

  • location_id (Integer) ID of the location you'd like to check the accessory in from.

  • checkin_date (String, required) Checkin date. Format: '2022-12-01'

  • notes (String) Notes.


POST '/checkin/component' - Checkin a component.

Parameters

  • component_id (Integer, required) Component ID.

  • asset_id (String, required) ID of the asset you'd like to check the component in from.

  • checkin_date (String, required) Checkin date. Format: '2022-12-01'

  • notes (String) Notes.

Checkout

POST '/checkout/asset' - Checkout an asset.

Parameters

  • asset_id (String, required) Asset ID.

  • employee_id (Integer) ID of the employee you'd like to check the asset out to.

  • location_id (Integer) ID of the location you'd like to check the asset out to.

  • checkout_date (String, required) Checkout date. Format: '2022-12-01'.

  • checkin_date (String) Checkin date.

  • condition (Integer) Condition.

  • notes (String) Notes.

  • asset_location_id (Integer) ID of the location you'd like the asset to belong to.

  • asset_department_id (Integer) ID of the department you'd like the asset to belong to.


POST '/checkout/accessory' - Checkout an accessory.

Parameters

  • accessory_id (Integer, required) Accessory ID.

  • employee_id (Integer) ID of the employee you'd like to check the accessory out to.

  • location_id (Integer) ID of the location you'd like to check the accessory out to.

  • quantity (Integer, required) Quantity.

  • checkout_date (String, required) Checkout date. Format: '2022-12-01'

  • notes (String) Notes.


POST '/checkout/component' - Checkout a component.

Parameters

  • component_id (Integer, required) Component ID.

  • asset_id (String, required) Asset ID.

  • quantity (Integer, required) Quantity.

  • checkout_date (String, required) Checkout date. Format: '2022-12-01'

  • notes (String) Notes.


POST '/checkout/consumable' - Checkout a consumable.

Parameters

  • consumable_id (Integer, required) Consumable ID.

  • employee_id (Integer) ID of the employee you'd like to check the consumable out to.

  • location_id (Integer) ID of the location you'd like to check the consumable out to.

  • quantity (Integer, required) Quantity.

  • checkout_date (Integer, required) Checkout date. Format: '2022-12-01'

  • notes (String) Notes.

Components

GET '/components' - Returns all components.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, model_number, order_number, purchase_date, purchase_cost, minimum_quantity, quantity, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • model_number (String) Exact search for model number.

  • order_number (String) Exact search for order number.

  • purchase_date (String) Exact search for purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Exact search for purchase price.

  • minimum_quantity (Integer) Exact search for minimum quantity.

  • quantity (Integer) Exact search for quantity.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Exact search for manufacturer id.

  • supplier_id (Integer) Exact search for supplier id.

  • location_id (Integer) Exact search for location id.

  • department_id (Integer) Exact search for department id.

  • notes (String) Exact search for notes.


GET '/components/:id' - Returns a specific component.

Parameters

  • id (Integer, required) The ID of the component.


POST '/components' - Create a component.

Parameters

  • name (String, required) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer, required) Quantity.

  • category_id (Integer, required) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/components/:id' - Update a component.

Parameters

  • id (Integer, required) The ID of the component.

  • name (String) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer) Quantity.

  • category_id (Integer) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/components/:id' - Delete a component.

Parameters

  • id (Integer, required) The ID of the accessory.

Consumables

GET '/consumables' - Returns all consumables.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, model_number, order_number, purchase_date, purchase_cost, minimum_quantity, available, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • model_number (String) Exact search for model number.

  • order_number (String) Exact search for order number.

  • purchase_date (String) Exact search for purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Exact search for purchase price.

  • minimum_quantity (Integer) Exact search for minimum quantity.

  • available (Integer) Exact search for available.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Exact search for manufacturer id.

  • supplier_id (Integer) Exact search for supplier id.

  • location_id (Integer) Exact search for location id.

  • department_id (Integer) Exact search for department id.

  • notes (String) Exact search for notes.


GET '/consumables/:id' - Returns a specific consumable.

Parameters

  • id (Integer, required) The ID of the consumable.


POST '/consumables' - Create a consumable.

Parameters

  • name (String, required) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer, required) Quantity.

  • category_id (Integer, required) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/components/:id' - Update a component.

Parameters

  • id (Integer, required) The ID of the component.

  • name (String) Name.

  • model_number (String) Model number.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase price.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency (or the location currency, if applicable). Accepts all ISO 4217 three-letter country codes.

  • minimum_quantity (Integer) Minimum quantity.

  • quantity (Integer) Quantity.

  • category_id (Integer) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/consumables/:id' - Delete a consumable.

Parameters

  • id (Integer, required) The ID of the consumable.

Departments

GET '/departments' - Returns all departments.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • email (String) Exact search for email.

  • phone (String) Exact search for phone.


GET '/departments/:id' - Returns a specific department.

Parameters

  • id (Integer, required) The ID of the department.


POST '/departments' - Create a department.

Parameters

  • name (String, required) Name.

  • email (String, required) Email.

  • phone (String, required) Phone.


PUT '/departments/:id' - Update a department.

Parameters

  • id (Integer, required) The ID of the department.

  • name (String) Name.

  • email (String) Email.

  • phone (String) Phone.


DELETE '/departments/:id' - Delete a department.

Parameters

  • id (Integer, required) The ID of the department.

Depreciations

GET '/depreciations' - Returns all depreciations.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, months, minimum_value }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • months (Integer) Exact search for number of months.

  • name (Integer) Exact search for minimum value after depreciation.


GET '/depreciations/:id' - Returns a specific depreciation.

Parameters

  • id (Integer, required) The ID of the depreciation.


POST '/depreciations' - Create a depreciation.

Parameters

  • name (String, required) Name.

  • months (Integer, required) Number of months.

  • name (Integer) Minimum value after depreciation.


PUT '/depreciations/:id' - Update a depreciation.

Parameters

  • id (Integer, required) The ID of the depreciation.

  • name (String) Name.

  • months (Integer) Number of months.

  • name (Integer) Minimum value after depreciation.


DELETE '/depreciations/:id' - Delete a depreciation.

Parameters

  • id (Integer, required) The ID of the depreciation.

Employees

GET '/employees' - Returns all employees.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, email, title, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • email (String) Exact search for email.

  • title (String) Exact search for title.

  • location_id (Integer) Exact search for location id.

  • department_id (Integer) Exact search for department id.

  • notes (String) Exact search for notes.


GET '/employees/:id' - Returns a specific employee.

Parameters

  • id (Integer, required) The ID of the employee.


POST '/employees' - Create a employee.

Parameters

  • name (String, required) Name.

  • email (String, required) Email.

  • title (String) Title.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • notes (String) Notes.


PUT '/employees/:id' - Update an employee.

Parameters

  • id (Integer, required) The ID of the employee.

  • name (String) Name.

  • email (String) Email.

  • title (String) Title.

  • location_id (Integer) Location id.

  • department_id (Integer) Department id.

  • notes (String) Notes.


DELETE '/employees/:id' - Delete an employee.

Parameters

  • id (Integer, required) The ID of the employee.

Licenses

GET '/licenses' - Returns all licenses.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, licensed_to_name, licensed_to_email, order_number, purchase_date, purchase_cost, expiration_date, termination_date, minimum_seats, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • licensed_to_name (String) Exact search for licensed to name.

  • licensed_to_email (String) Exact search for licensed to email.

  • order_number (String) Exact search for order number.

  • purchase_date (String) Exact search for purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Exact search for purchase cost.

  • expiration_date (String) Exact search for expiration date. Format: '2022-12-01'

  • termination_date (String) Exact search for termination date. Format: '2022-12-01'

  • minimum_seats (Integer) Exact search for minimum seats.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Exact search for manufacturer id.

  • supplier_id (Integer) Exact search for supplier id.

  • depreciation_id (Integer) Exact search for depreciation id.

  • department_id (Integer) Exact search for department id.

  • notes (String) Exact search for notes.


GET '/licenses/:id' - Returns a specific license.

Parameters

  • id (Integer, required) The ID of the license.


POST '/license' - Create a license.

Parameters

  • name (String, required) Name.

  • licensed_to_name (String) Licensed to name.

  • licensed_to_email (String) Licensed to email.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase cost.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency. Accepts all ISO 4217 three-letter country codes.

  • expiration_date (String) Expiration date. Format: '2022-12-01'

  • termination_date (String) Termination date. Format: '2022-12-01'

  • minimum_seats (Integer) Minimum seats.

  • category_id (Integer, required) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • depreciation_id (Integer) Depreciation id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/licenses/:id' - Update a license.

Parameters

  • id (Integer, required) The ID of the license.

  • name (String) Name.

  • licensed_to_name (String) Licensed to name.

  • licensed_to_email (String) Licensed to email.

  • order_number (String) Order number.

  • purchase_date (String) Purchase date. Format: '2022-12-01'

  • purchase_cost (Integer) Purchase cost.

  • currency (String) The currency of the purchase price. Only needed if it's different from the default account currency. Accepts all ISO 4217 three-letter country codes.

  • expiration_date (String) Expiration date. Format: '2022-12-01'

  • termination_date (String) Termination date. Format: '2022-12-01'

  • minimum_seats (Integer) Minimum seats.

  • category_id (Integer) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • supplier_id (Integer) Supplier id.

  • depreciation_id (Integer) Depreciation id.

  • department_id (Integer) Department id.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/licenses/:id' - Delete a license.

Parameters

  • id (Integer, required) The ID of the license.

Locations

GET '/locations' - Returns all locations.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, address_line_1, address_line_2, city, zip, state, country }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • address_line_1 (String) Exact search for address line 1.

  • address_line_2 (String) Exact search for address line 2.

  • city (String) Exact search for city.

  • zip (String) Exact search for zip.

  • state (String) Exact search for state.

  • country (String) Exact search for country.

  • email (String) Exact search for email.

  • phone (String) Exact search for phone.

  • currency (String) Exact search for currency.


GET '/locations/:id' - Returns a specific location.

Parameters

  • id (Integer, required) The ID of the location.


POST '/locations' - Create a location.

Parameters

  • name (String, required) Name.

  • address_line_1 (String) Address line 1.

  • address_line_2 (String) Address line 2.

  • city (String) City.

  • zip (String) Zip.

  • state (String) State.

  • country (String) Country.

  • email (String) Email.

  • phone (String) Phone.

  • currency (String) Currency (ISO 4217 Code).

  • logo (String) External URL to logo.


PUT '/locations/:id' - Update a location.

Parameters

  • id (Integer, required) The ID of the location.

  • name (String) Name.

  • address_line_1 (String) Address line 1.

  • address_line_2 (String) Address line 2.

  • city (String) City.

  • zip (String) Zip.

  • state (String) State.

  • country (String) Country.

  • email (String) Email.

  • phone (String) Phone.

  • currency (String) Currency (ISO 4217 Code).

  • logo (String) External URL to logo.


DELETE '/locations/:id' - Delete a location.

Parameters

  • id (Integer, required) The ID of the location.

Maintenances

GET '/maintenances' - Returns all maintenances.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, type, name, start_date, end_date, cost, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • type (String) Exact search for type. Options: { maintenance, repair, upgrade, test, calibration, hardware support, software support }

  • name (String) Exact search for name.

  • start_date (String) Exact search start date. Format: '2022-12-01'

  • end_date (String) Exact search for end date. Format: '2022-12-01'

  • cost (Integer) Exact search for cost.

  • asset_id (String) Exact search for asset id.

  • supplier_id (Integer) Exact search for supplier id.

  • notes (String) Exact search for notes.


GET '/maintenances/:id' - Returns a specific maintenance.

Parameters

  • id (Integer, required) The ID of the maintenance.


POST '/maintenances' - Create a maintenance.

Parameters

  • type (String, required) Type. Options: { maintenance, repair, upgrade, test, calibration, hardware support, software support }

  • name (String, required) Name.

  • start_date (String, required) Start date. Format: '2022-12-01'

  • end_date (String) End date. Format: '2022-12-01'

  • cost (Integer) Cost.

  • asset_id (String, required) Asset id.

  • supplier_id (Integer, required) Supplier id.

  • notes (String) Notes.


PUT '/maintenances/:id' - Update a maintenance.

Parameters

  • id (Integer, required) The ID of the location.

  • type (String) Type. Options: { maintenance, repair, upgrade, test, calibration, hardware_support, software_support }

  • name (String) Name.

  • start_date (String) Start date. Format: '2022-12-01'

  • end_date (String) End date. Format: '2022-12-01'

  • cost (Integer) Cost.

  • asset_id (String) Asset id.

  • supplier_id (Integer) Supplier id.

  • notes (String) Notes.


DELETE '/maintenances/:id' - Delete a maintenance.

Parameters

  • id (Integer, required) The ID of the maintenance.

Manufacturers

GET '/manufacturers' - Returns all manufacturers.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, url, support_url, support_phone, support_email, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • url (String) Exact search for url.

  • support_url (String) Exact search for support url.

  • support_phone (String) Exact search for support phone.

  • support_email (String) Exact search for support email.

  • notes (String) Exact search for notes.


GET '/manufacturers/:id' - Returns a specific manufacturer.

Parameters

  • id (Integer, required) The ID of the manufacturer.


POST '/manufacturers' - Create a manufacturer.

Parameters

  • name (String, required) Name.

  • url (String) Url.

  • support_url (String) Support url.

  • support_phone (String) Support phone.

  • support_email (String) Support email.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/manufacturers/:id' - Update a manufacturer.

Parameters

  • id (Integer, required) The ID of the location.

  • name (String) Name.

  • url (String) Url.

  • support_url (String) Support url.

  • support_phone (String) Support phone.

  • support_email (String) Support email.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/manufacturers/:id' - Delete a manufacturer.

Parameters

  • id (Integer, required) The ID of the manufacturer.

Products

GET '/products' - Returns all products.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, model_number, eol, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • model_number (String) Exact search for model number.

  • end_of_life_date (String) Exact search for end of life date. Format: '2022-12-01'.

  • default_purchase_cost (Integer) Exact search for default purchase cost.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Exact search for manufacturer id.

  • depreciation_id (Integer) Exact search for depreciation id.

  • notes (String) Exact search for notes.

  • archived (Boolean) Exact search for archived.


GET '/products/:id' - Returns a specific product.

Parameters

  • id (Integer, required) The ID of the product.


POST '/products' - Create a product.

Parameters

  • name (String, required) Name.

  • model_number (String) Model number.

  • end_of_life_date (String) End of life date. Format: '2022-12-01'.

  • default_purchase_cost (Integer) Default purchase cost.

  • category_id (Integer, required) Category id.

  • manufacturer_id (Integer) Manufacturer id.

  • depreciation_id (Integer) Depreciation id.

  • logo (String) External URL to logo.

  • notes (String) Notes.

  • archived (Boolean) Archived.


PUT '/products/:id' - Update a product.

Parameters

  • id (Integer, required) The ID of the product.

  • name (String) Name.

  • model_number (String) Model number.

  • end_of_life_date (String) End of life date. Format: '2022-12-01'.

  • default_purchase_cost (Integer) Default purchase cost.

  • category_id (Integer) Exact search for category id.

  • manufacturer_id (Integer) Manufacturer id.

  • depreciation_id (Integer) Depreciation id.

  • logo (String) External URL to logo.

  • notes (String) Notes.

  • archived (Boolean) Archived.


DELETE '/products/:id' - Delete a product.

Parameters

  • id (Integer, required) The ID of the product.

Statuses

GET '/statuses' - Returns all statuses.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, type, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • type (String) Exact search for type. Options: { deployable, pending, undeployable, archived }

  • show_in_nav (Boolean) Exact search for if status is visible in the navigation bar.

  • notes (String) Exact search for notes.


GET '/statuses/:id' - Returns a specific status.

Parameters

  • id (Integer, required) The ID of the status.


POST '/statuses' - Create a status.

Parameters

  • name (String, required) Name.

  • type (String, required) Type. Options: { deployable, pending, undeployable, archived }

  • show_in_nav (Boolean) If status is visible in the navigation bar.

  • notes (String) Notes.


PUT '/statuses/:id' - Update a status.

Parameters

  • id (Integer, required) The ID of the product.

  • name (String) Name.

  • type (String) Type. Options: { deployable, pending, undeployable, archived }

  • show_in_nav (Boolean) If status is visible in the navigation bar.

  • notes (String) Notes.


DELETE '/statuses/:id' - Delete a status.

Parameters

  • id (Integer, required) The ID of the status.

Suppliers

GET '/suppliers' - Returns all suppliers.

Parameters

  • limit (Integer) Max number of entries to return. Default value is 50.

  • sort (String) Which column to sort the results by. Default value is name.
    Options: { created_at, updated_at, name, address_line_1, address_line_2, city, zip, state, country, contact_name, phone, fax, email, url, notes }

  • order (String) Order to sort the results by. Default value is asc.
    Options: { asc, desc }

  • offset (Integer) Offset results by a number. Default value is 0.

  • name (String) Exact search for name.

  • address_line_1 (String) Exact search for address line 1.

  • address_line_2 (String) Exact search for address line 2.

  • city (String) Exact search for city.

  • zip (String) Exact search for zip.

  • state (String) Exact search for state.

  • country (String) Exact search for country.

  • contact_name (String) Exact search for contact name.

  • phone (String) Exact search for phone.

  • fax (String) Exact search for fax.

  • email (String) Exact search for email.

  • url (String) Exact search for url.

  • notes (String) Exact search for notes.


GET '/suppliers/:id' - Returns a specific supplier.

Parameters

  • id (Integer, required) The ID of the supplier.


POST '/suppliers' - Create a supplier.

Parameters

  • name (String, required) Name.

  • address_line_1 (String) Aaddress line 1.

  • address_line_2 (String) Address line 2.

  • city (String) City.

  • zip (String) Zip.

  • state (String) State.

  • country (String) Country.

  • contact_name (String) Contact name.

  • phone (String) Phone.

  • fax (String) Fax.

  • email (String) Email.

  • url (String) Url.

  • logo (String) External URL to logo.

  • notes (String) Notes.


PUT '/suppliers/:id' - Update a supplier.

Parameters

  • id (Integer, required) The ID of the supplier.

  • name (String) Name.

  • address_line_1 (String) Aaddress line 1.

  • address_line_2 (String) Address line 2.

  • city (String) City.

  • zip (String) Zip.

  • state (String) State.

  • country (String) Country.

  • contact_name (String) Contact name.

  • phone (String) Phone.

  • fax (String) Fax.

  • email (String) Email.

  • url (String) Url.

  • logo (String) External URL to logo.

  • notes (String) Notes.


DELETE '/suppliers/:id' - Delete a supplier.

Parameters

  • id (Integer, required) The ID of the supplier.