Find and rank lawyers for a legal matter
find_attorneysFind licensed lawyers for a matter and rank them by practice-area fit, location, years licensed, timing, price and preferences, with plain-language reasons, data sources and gaps. Returns up to 5 by default, or an honest no-match. Not legal advice.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5-digit ZIP code, only if the user agreed to share it | |
| city | No | ||
| court | No | ||
| limit | No | ||
| state | No | US state, two-letter code or name, e.g. CA or California | |
| county | No | ||
| urgency | No | ||
| category | No | ||
| languages | No | ||
| remote_ok | No | User is willing to work with a lawyer remotely (phone or video) anywhere in the state | |
| budget_max | No | Total budget the user mentioned, in US dollars | |
| budget_min | No | ||
| priorities | No | What matters most, in order. Shifts ranking weights. | |
| client_side | No | Which side the user is on. ALCBar has no record of which side lawyers usually represent, so results carry a warning to ask. | |
| description | No | Short description of the legal need in the user's words. Used only to pick a practice area; not stored. | |
| matter_type | No | ||
| communication | No | ||
| deadline_date | No | A deadline the USER reported (hearing, filing, response). ALCBar does not verify or calculate deadlines. | |
| deadline_type | No | ||
| practice_area | No | Practice area, e.g. 'Landlord-Tenant Law', 'Family Law', 'Criminal Law' | |
| service_needed | No | ||
| consultation_by | No | Latest date the user wants a first consultation | |
| procedural_stage | No | ||
| subpractice_area | No | ||
| attribution_token | No | Signed campaign/partner token issued by ALCBar, if the user arrived through a partner link | |
| language_required | No | True if the language is essential, not just preferred | |
| preference_set_id | No | Saved criteria from update_matching_preferences | |
| billing_preference | No | ||
| min_years_licensed | No | ||
| accessibility_needs | No | ||
| payment_plan_needed | No | ||
| exclude_attorney_ids | No | ||
| max_consultation_fee | No | 0 means the user wants a free first consultation | |
| reduced_fee_eligible | No | User may qualify for pro bono, legal aid or reduced fees | |
| representation_start_by | No | Date as YYYY-MM-DD | |
| include_unconfirmed_practice_area | No | Also include licensed lawyers whose practice areas are not on record (labeled clearly) |