Guides

Firms

Firms don't appear in bar directories, so we infer them: attorneys are clustered by employment signals, the clusters are confirmed against state Secretary-of-State filings where possible, and non-law entities (medical PAs, vet practices) plus solo-attorney noise are filtered out. What's left is a firm record you can trust for CRM enrichment, conflict checks, and opposing-counsel research — with the same per-field provenance as attorneys.

What a firm record contains

Firms carry public ids (firm_…), canonical + variant names, website, jurisdictions, a primary address, current attorney count, and — where a state filing was matched — entityStatus and entityFormedAt from the Secretary of State. Officer/director titles from those filings surface on the attorneys themselves (firmTitles).

Endpoints

GET/firms/lookup

Full-text search of verified law firms across canonical + variant names.

name
string — required
jurisdiction
string — two-letter US state code
limit
integer 1–100 (default 25)

Example response

{
  "results": [
    {
      "firm": {
        "id": "firm_8Q1yTf3kPw",
        "canonicalName": "Smith & Alvarez LLP",
        "variantNames": ["Smith and Alvarez"],
        "websiteUrl": "https://smithlaw.com",
        "jurisdictions": ["FL"],
        "address": { "line1": "100 SE 2nd St", "city": "Miami", "state": "FL", "postalCode": "33131" },
        "attorneyCount": 14,
        "entityStatus": "ACTIVE",          // from FL Division of Corporations
        "entityFormedAt": 1104537600000
      },
      "_meta": { "fieldSources": { "...": "..." }, "lastReconciledAt": 1752019200000 }
    }
  ]
}
GET/firms/{id}

Canonical firm view with address, jurisdictions, entity status, and attorney count.

GET/firms/{id}/attorneys

Current attorneys at the firm, each in the full AttorneyResponse shape (including officer/director titles from SOS filings where known).

limit
integer 1–500 (default 100)

Reading firm data well

  • Employment freshness — an attorney's currentFirmId updates as bar and website signals change; check _meta.fieldSources.currentFirmId for when and from where.
  • Entity status is a signal, not a verdict — an INACTIVE SOS status can mean a re-registration, not a closed firm. The provenance tells you which filing said it and when.
  • Variant names matter— search “Smith and Alvarez” or “Smith & Alvarez”; both resolve. Use the canonical name for display, keep the public id as your key.