Find Company By Email (lawmatics_find-company-by-email)
Fuzzy-find a single company in Lawmatics by email address. Searches the company's own email, then falls back to associated contacts. Returns company details, postal addresses, and a `relationships` envelope of {id,type} pointers to related records (primary contact, associated contacts and matters, tags, emails, phone numbers, addresses, notes, and the creating user). Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.
Tool Input
emailAddressstring(email)required— Email address to search for. Lawmatics matches the company's own email, then falls back to searching associated contacts.(pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$)
Tool Output
matchobjectnullrequired— The single best matching company, or null if nothing matched. Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.
idstringrequired— Lawmatics company ID
namestringrequired— Company name
emailstringnullrequired— Company email address; null if unset
addressstringnullrequired— Full formatted address as a single line; null if unset
citystringnullrequired— City; null if unset
statestringnullrequired— State or province; null if unset
postalCodestringnullrequired— Postal/ZIP code; null if unset
countrystringnullrequired— Country; null if unset
phoneNumberstringnullrequired— Company phone number, as stored; null if unset
createdAtstringrequired— When the company was created, as an ISO 8601 timestamp
updatedAtstringrequired— When the company was last updated, as an ISO 8601 timestamp
addressesarrayrequired— Structured postal addresses on the company; may be empty
[]object
14 fields
idnumberrequired— Address record ID
streetstringrequired— Street address line 1
street2stringnullrequired— Street address line 2 (suite, unit); null if unset
citystringrequired— City
statestringrequired— State or province
postalCodestringrequired— Postal/ZIP code
countrystringrequired— Country
labelstringrequired— Address label (e.g. Primary, Billing)
addressableTypestringrequired— Type of record this address belongs to (e.g. Company)
addressableIdnumberrequired— ID of the record this address belongs to
firmIdnumberrequired— ID of the Lawmatics firm that owns this address
deletedAtstringnullrequired— Soft-deletion timestamp as ISO 8601; null if not deleted
createdAtstringrequired— When the address was created, as an ISO 8601 timestamp
updatedAtstringrequired— When the address was last updated, as an ISO 8601 timestamp
relationshipsobjectrequired— JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'contact' -> get-contact, type 'user' -> get-user). Distinct from the `addresses` attribute array above, which carries the nested address objects directly.
primaryContactobjectnullrequired— Primary contact pointer; null when unset
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
createdByobjectnullrequired— Creating user pointer; null when unset
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
contactsarrayrequired— Associated contact pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
prospectsarrayrequired— Associated matter (prospect) pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
tagsarrayrequired— Tag pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
emailsarrayrequired— Email-address pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
phoneNumbersarrayrequired— Phone-number pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
addressesarrayrequired— Address pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
notesarrayrequired— Note pointers; empty if none
1 field
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool