Licenses

Manage software licenses via the API

The Licenses API allows you to manage software licenses and their seats in Snipe-IT.

List Licenses

cURL

curl -X GET "https://your-domain.com/api/v1/licenses" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

limit · integer · default: "50"

Number of results to return

offset · integer · default: "0"

Offset for pagination

search · string

Search string to filter results

sort · string · default: "created_at"

Column to sort by. Allowed values: id, name, purchase_cost, expiration_date, purchase_order, order_number, notes, purchase_date, serial, seats, free_seats_count

order · string · default: "desc"

Sort order: asc or desc

status · string

Filter by status: active, inactive, expiring

company_id · integer

Filter by company ID

manufacturer_id · integer

Filter by manufacturer ID

supplier_id · integer

Filter by supplier ID

category_id · integer

Filter by category ID

depreciation_id · integer

Filter by depreciation ID

total · integer

Total number of licenses

rows · array

Array of license objects

Show License Object

id · integer

License ID

name · string

License name

product_key · string

Product key/serial

seats · integer

Total number of seats

free_seats_count · integer

Number of available seats

license_name · string

Licensee name

license_email · string

Licensee email

purchase_order · string

Purchase order number

order_number · string

Order number

purchase_date · string

Purchase date

purchase_cost · string

Purchase cost

expiration_date · string

Expiration date

termination_date · string

Termination date

maintained · boolean

Whether license is maintained

notes · string

License notes

company · object

Company information

manufacturer · object

Manufacturer information

supplier · object

Supplier information

category · object

Category information

Get License by ID

cURL

curl -X GET "https://your-domain.com/api/v1/licenses/{license_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

license_id · integer · required

The license ID

Create License

cURL

curl -X POST "https://your-domain.com/api/v1/licenses" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Adobe Creative Cloud",
    "seats": 10,
    "category_id": 1,
    "manufacturer_id": 5
  }'

name · string · required

License name

seats · integer · required

Number of seats

category_id · integer · required

Category ID

company_id · integer

Company ID

manufacturer_id · integer

Manufacturer ID

product_key · string

Product key/serial number

order_number · string

Order number

purchase_order · string

Purchase order number

purchase_date · string

Purchase date (YYYY-MM-DD)

purchase_cost · number

Purchase cost

expiration_date · string

Expiration date (YYYY-MM-DD)

license_name · string

Licensee name

license_email · string

Licensee email

maintained · boolean

Whether license is maintained

supplier_id · integer

Supplier ID

notes · string

License notes

Update License

cURL

curl -X PATCH "https://your-domain.com/api/v1/licenses/{license_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated License Name",
    "seats": 15
  }'

license_id · integer · required

The license ID

Delete License

cURL

curl -X DELETE "https://your-domain.com/api/v1/licenses/{license_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

license_id · integer · required

The license ID

List License Seats

cURL

curl -X GET "https://your-domain.com/api/v1/licenses/{license_id}/seats" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

license_id · integer · required

The license ID

Returns all seats for a specific license, including assigned and available seats.

Get License Seat

cURL

curl -X GET "https://your-domain.com/api/v1/licenses/{license_id}/seats/{seat_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

license_id · integer · required

The license ID

seat_id · integer · required

The seat ID

Update License Seat

Used to checkout or checkin a license seat.

Checkout

curl -X PATCH "https://your-domain.com/api/v1/licenses/{license_id}/seats/{seat_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "assigned_to": 123,
    "note": "Assigned to employee"
  }'

license_id · integer · required

The license ID

seat_id · integer · required

The seat ID

assigned_to · integer

User ID to assign seat to (set to null to checkin)

asset_id · integer

Asset ID to associate with this seat

note · string

Checkout/checkin note