Get a company | Distru Documentation

Gets one customer, vendor or your own company, with its licenses, addresses and default order notes.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
id	string	Yes	Resolve via distru-search-companies.
includeContacts	boolean	No	contacts is empty without permission to view contacts.
includeLocations	boolean	No	Addresses.
includeLicenses	boolean	No	State cannabis licenses. Customer and vendor license numbers are user-entered, not checked against Metrc.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence	Description
company	object	Can be null
company.id	string	Always
company.name	string	Null or absent
company.isMyCompany	boolean	Always
company.customFields	object[]	Always
company.customFields[].customField	object	Always
company.customFields[].customField.id	string	Always
company.customFields[].customField.name	string	Always
company.customFields[].customField.fieldType	enum `CHECKBOXDATEDROPDOWNTEXT`	Always
company.customFields[].value	string	Can be null	Null when unset. DATE values are days (YYYY-MM-DD) in the company timezone; CHECKBOX values are the selected option names, separated by commas.
company.legalBusinessName	string	Null or absent
company.category	string	Null or absent
company.creditBalance	string	Null or absent
company.outstandingBalance	string	Null or absent
company.pastDueBalance	string	Null or absent
company.outstandingBalanceThreshold	integer	Null or absent
company.invoiceEmail	string	Null or absent
company.defaultPaymentTerm	object	Null or absent
company.defaultPaymentTerm.id	string	Always
company.defaultPaymentTerm.name	string	Null or absent
company.owner	object	Null or absent
company.owner.id	string	Always
company.owner.fullName	string	Null or absent
company.defaultInventoryLocation	object	Null or absent
company.defaultInventoryLocation.id	string	Always
company.defaultInventoryLocation.name	string	Null or absent
company.lastOrderDate	string	Null or absent
company.relationshipType	object	Null or absent
company.relationshipType.id	string	Always
company.relationshipType.name	string	Always
company.group	object	Null or absent
company.group.id	string	Always
company.group.name	string	Always
company.email	string	Null or absent
company.phone	string	Null or absent
company.website	string	Null or absent
company.qbCustomerId	string	Null or absent
company.qbCustomer	object	Null or absent
company.qbCustomer.displayName	string	Always
company.qbCustomer.active	boolean	Always
company.qbCustomer.isDeleted	boolean	Always
company.qbVendorId	string	Null or absent
company.qbVendor	object	Null or absent
company.qbVendor.displayName	string	Always
company.qbVendor.active	boolean	Always
company.qbVendor.isDeleted	boolean	Always
company.leaflinkBrandId	string	Null or absent
company.leaflinkCustomerId	string	Null or absent
company.usState	string	Null or absent
company.description	string	Null or absent
company.defaultSalesOrderNotes	string	Null or absent
company.defaultPurchaseOrderNotes	string	Null or absent
company.salesOrderEmail	string	Null or absent
company.orderShipmentEmail	string	Null or absent
company.purchaseOrderEmail	string	Null or absent
company.contacts	object[]	Can be absent
company.contacts[].id	string	Always
company.contacts[].firstName	string	Always
company.contacts[].lastName	string	Null or absent
company.contacts[].title	string	Null or absent
company.contacts[].description	string	Null or absent
company.contacts[].email	string	Null or absent
company.contacts[].phone	string	Null or absent
company.contacts[].workPhone	string	Null or absent
company.contacts[].owner	object	Null or absent
company.contacts[].owner.id	string	Always
company.contacts[].owner.fullName	string	Null or absent
company.contacts[].driverLicenseNumber	string	Null or absent
company.contacts[].driverLicenseIssuingState	string	Null or absent
company.contacts[].customFields	object[]	Always
company.contacts[].customFields[].customField	object	Always
company.contacts[].customFields[].customField.id	string	Always
company.contacts[].customFields[].customField.name	string	Always
company.contacts[].customFields[].customField.fieldType	enum `CHECKBOXDATEDROPDOWNTEXT`	Always
company.contacts[].customFields[].value	string	Can be null	Null when unset. DATE values are days (YYYY-MM-DD) in the company timezone; CHECKBOX values are the selected option names, separated by commas.
company.locations	object[]	Can be absent
company.locations[].id	string	Always
company.locations[].name	string	Always
company.locations[].streetAddress	string	Always
company.locations[].apt	string	Null or absent
company.locations[].city	string	Always
company.locations[].state	string	Always
company.locations[].zip	string	Always
company.locations[].country	string	Always
company.locations[].license	object	Null or absent
company.locations[].license.id	string	Always
company.locations[].license.licenseNumber	string	Always
company.licenses	object[]	Can be absent
company.licenses[].id	string	Always
company.licenses[].licenseNumber	string	Always
company.licenses[].licenseType	string	Always
company.licenses[].complianceType	enum `BIOTRACKMETRCNONE`	Always
company.licenses[].isActive	boolean	Always
company.licenses[].issueDatetime	string	Null or absent
company.licenses[].expiryDatetime	string	Always

What the AI reads

Gets one company by ID — a customer, a vendor, or the user's own company (isMyCompany): the distru-search-companies summary plus its US state, description, default sales and purchase order notes, and the emails its documents go to. Contacts, locations and licenses are left out unless you pass includeContacts, includeLocations or includeLicenses. Use for a specific company after resolving its ID via distru-search-companies; to browse companies use distru-search-companies. qbCustomerId and qbVendorId are its QuickBooks customer and vendor IDs, null when not mapped. qbCustomer and qbVendor are null when mapped but Distru has no current copy of the QuickBooks record. isDeleted means QuickBooks no longer has the record, and active indicates whether the record is active in QuickBooks. An invoice sync re-maps a deleted or missing customer by name, or creates one, but fails on an inactive one. Null if no company matches the ID; a permission error if the caller can't view it.