Skip to content
Sign in

LCM field reference

These are the contract and license fields in License and Contracts Manager. The names are the canonical names. They match the column headers in the LCM template and the keys used by the API and integrations. Labels on the forms are friendlier. The fields underneath are these.

The schema can be extended for the project with custom fields. Constrained fields such as contract_type and status accept a defined set. Common values are below. The canonical list is the dropdown on the form, and it can grow.

A contract is one software agreement: commercial terms, dates, vendor and renewal information.

FieldTypeWhat it holds
contract_numberstringUnique identifier, for example AGR-12345. The business key that links the contract to its licenses.
contract_namestringA clear name, for example Adobe Creative Cloud 2025.
contract_typestring, constrainedThe kind of contract. See common values below.
legal_entitystringThe company in your organization that signed, for example Acme Inc..
vendor_namestringThe company providing the product or service, for example Microsoft.
start_datestring, YYYY-MM-DDThe date the contract begins.
end_datestring, YYYY-MM-DDThe date the contract ends.
FieldTypeWhat it holds
statusstring, constrainedCurrent state. Defaults to Automatic, derived from the dates.
business_ownerstringThe person responsible, as a name or an email.
po_numberstringPurchase order number, for example PO-12345.
invoice_numberstringInvoice reference, for example INV-12345.
total_valuenumberTotal cost of the contract. Spend charts read this.
currencystringThree-letter ISO code, for example USD, EUR or GBP.
purchase_datestring, YYYY-MM-DDThe date the contract was bought.
renewal_datestring, YYYY-MM-DDThe date to review for renewal.
renewal_notice_daysnumberDays before the end date for the first reminder. See Renewals & Lifecycle.
sla_termsstringService level details, such as an uptime guarantee.
reseller_namestringThe company that sold the product, if there is one.
reseller_typestringThe kind of reseller, for example distributor.
notesstringFree-text internal notes.
descriptionstringWhat the contract covers. NEO also writes extracted custom values here.

Common contract_type values on the form: License Agreement, Enterprise Agreement, Support Agreement, Subscription Agreement, Reseller Agreement, Audit Agreement, Evaluation Agreement, Custom Agreement, Service Agreement.

Common status values: Automatic, Active, Expired, Future, Renewed, Terminated. Automatic follows the start and end dates.

A license is one entitlement under a contract, linked by contract_number.

FieldTypeWhat it holds
contract_numberstringThe parent contract’s contract_number.
license_namestringWhat the entitlement is. With contract_number, this is the business key the upload matches on.
license_typestring, constrainedThe kind of license. See common values below.
quantitynumberUnits included. On Edit License this is Quantity, and it is required.
unlimited_quantitybooleanThe Unlimited Quantity checkbox under Quantity. True for a site license or another uncapped entitlement. Otherwise False. Entering 0 does not mean unlimited.
FieldTypeWhat it holds
statusstring, constrainedWhether the license is active. Defaults to Automatic. Common values: Automatic, Active, Inactive.
use_contract_datesbooleanWhether the license inherits its dates from the contract. Defaults to True. Set False to use the license start_date and end_date.
start_datestring, YYYY-MM-DDLicense start. Used only when use_contract_dates is False.
end_datestring, YYYY-MM-DDLicense end. Used only when use_contract_dates is False.
license_metricstringHow the license is measured, for example per user, per device or per core.
license_keystringThe activation key or license code.
skustringA code for the specific product version.
pricenumberCost per unit.
currencystringThree-letter ISO code for the price.
has_maintenancebooleanWhether the license includes support or updates.
downgrade_rightsbooleanWhether the license allows an older version.
descriptionstringExtra detail on what the entitlement covers.
websitestringLink to the product or vendor site.
product_publisherstringThe company that makes the product.
product_namestringThe product name. Optional, because a bundle or a pool may not map to one product.
product_editionstringEdition, for example E3, Enterprise or Standard.
product_versionstringVersion number or year.
notesstringFree-text internal notes.

Common license_type values on the form: Perpetual, Subscription, Open-Source, Freeware, Support, Maintenance.

On Edit License, Quantity is required and Unlimited Quantity is the checkbox under it. Tick the checkbox for an uncapped entitlement. Entering 0 does not mean unlimited. In the template, that checkbox is unlimited_quantity. Allocations against an unlimited license still consume from it, but Available is meaningless because there is no fixed cap.

use_contract_dates defaults to True. Most licenses inherit the contract term, which is right when the contract grants one or more licenses for the same period. Use the license dates only when the license has a different period, for example a license that starts part way through a multi-year contract.

For contract_type, status and license_type, the bulk upload checks the current allowed values. If a row is rejected for one of those fields, open the manual form and use the list there.

Per-record custom fields stay on that one record and are not part of the bulk schema. Settings template fields become fields for the whole project and appear as columns on the next template download.

  • The LCM template, where the column headers are these names
  • The manual forms, where the labels differ and the stored fields do not
  • The reports, where the names appear as chart dimensions and column headers
  • Exports, which use these names as column headers
  • Integrations and the API, which follow this model