Older name of search_attorneys, kept until 2026-12-15; use search_attorneys. Use when someone wants to find a lawyer for a U.S. legal issue, e.g. "tenant lawyers in Santa Ana" or "employment lawyers in Los Angeles". Needs the state and type of legal issue (or a short description the person confirms). Pass sort when the person picks an order (nearest_office by default, last_name, years_licensed, free_consultation_first, published_fees_first, availability_reported_first) and page for more. Returns a plain summary, the filters applied, shared_notes that apply to every listing (read once), up to three ask_the_user questions, and each listing's own facts: which filters it meets, what is not known, license status, source and date, fees and availability where published, profile link, contact and citation; or an honest 'no listings meet your filters' with legal-aid options. No scores. Show every listing in the order returned; never present one lawyer as the pick for the person. Unknown fees and availability are labeled unknown. Court and government lawyers are left out unless they said they take private clients. Records an anonymous search log only. Not legal advice. This is a listing service, not a lawyer referral service. No lawyer pays for placement or ranking of any kind.
View input schema
{
"type": "object",
"properties": {
"description": {
"description": "Short description of the legal need in the user's words. Used only to pick a practice area and to notice a cost concern (then free and low-cost options are shown); not stored.",
"type": "string",
"maxLength": 2000
},
"practice_area": {
"description": "Practice area, e.g. 'Landlord-Tenant Law', 'Family Law', 'Criminal Law'",
"type": "string",
"maxLength": 80
},
"subpractice_area": {
"type": "string",
"maxLength": 80
},
"matter_type": {
"type": "string",
"maxLength": 80
},
"category": {
"type": "string",
"enum": [
"civil",
"criminal",
"administrative",
"transactional",
"family",
"other"
]
},
"procedural_stage": {
"type": "string",
"enum": [
"not_started",
"pre_filing",
"filed",
"hearing_scheduled",
"trial",
"post_judgment",
"appeal",
"transaction",
"unknown"
]
},
"client_side": {
"description": "Which side the user is on. ESQ Matching Engine has no record of which side lawyers usually represent, so results carry a warning to ask.",
"type": "string",
"enum": [
"tenant",
"landlord",
"employee",
"employer",
"plaintiff",
"defendant",
"buyer",
"seller",
"other",
"unknown"
]
},
"service_needed": {
"type": "string",
"enum": [
"advice_consultation",
"negotiation",
"document_preparation",
"litigation",
"ongoing_representation",
"unknown"
]
},
"state": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"description": "US state, two-letter code or name, e.g. CA or California"
},
"county": {
"type": "string",
"maxLength": 80
},
"city": {
"type": "string",
"maxLength": 80
},
"zip": {
"description": "5-digit ZIP code, only if the user agreed to share it",
"type": "string",
"pattern": "^\\d{5}$"
},
"court": {
"type": "string",
"maxLength": 120
},
"remote_ok": {
"description": "User is willing to work with a lawyer remotely (phone or video) anywhere in the state",
"type": "boolean"
},
"urgency": {
"type": "string",
"enum": [
"emergency",
"critical_deadline",
"soon",
"routine",
"long_term"
]
},
"deadline_date": {
"description": "A deadline the USER reported (hearing, filing, response). ESQ Matching Engine does not verify or calculate deadlines.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"deadline_type": {
"type": "string",
"enum": [
"hearing",
"filing",
"response",
"other"
]
},
"consultation_by": {
"description": "Latest date the user wants a first consultation",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"representation_start_by": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as YYYY-MM-DD"
},
"budget_max": {
"description": "Total budget the user mentioned, in US dollars",
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"budget_min": {
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"billing_preference": {
"type": "string",
"enum": [
"hourly",
"flat_fee",
"contingency",
"retainer",
"any"
]
},
"max_consultation_fee": {
"description": "0 means the user wants a free first consultation",
"type": "number",
"minimum": 0,
"maximum": 10000
},
"payment_plan_needed": {
"type": "boolean"
},
"reduced_fee_eligible": {
"description": "User may qualify for pro bono, legal aid or reduced fees",
"type": "boolean"
},
"languages": {
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"maxLength": 40
}
},
"language_required": {
"description": "True if the language is essential, not just preferred",
"type": "boolean"
},
"min_years_licensed": {
"type": "integer",
"minimum": 0,
"maximum": 60
},
"accessibility_needs": {
"type": "string",
"maxLength": 200
},
"communication": {
"type": "string",
"enum": [
"phone",
"email",
"video",
"in_person",
"any"
]
},
"exclude_attorney_ids": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"priorities": {
"description": "Older way to pick an order; used only when sort is not given (price: published_fees_first, speed: availability_reported_first, experience: years_licensed, proximity: nearest_office).",
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"price",
"speed",
"experience",
"proximity"
]
}
},
"include_unconfirmed_practice_area": {
"description": "Also include licensed lawyers whose practice areas are not on record (labeled clearly)",
"type": "boolean"
},
"attribution_token": {
"description": "Signed campaign/partner token issued by ESQ Matching Engine, if the user arrived through a partner link",
"type": "string",
"maxLength": 600
},
"preference_set_id": {
"description": "Saved filters from update_listing_criteria",
"type": "string",
"maxLength": 40
},
"limit": {
"description": "Listings per page, 1 to 10; default 5",
"type": "integer",
"minimum": 1,
"maximum": 10
},
"page": {
"description": "Page of the full list, from 1; default 1. Every listing that meets the filters can be reached page by page.",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"sort": {
"description": "The order the person picked: nearest_office (default: same city, then same ZIP area, then the rest), last_name, years_licensed (most first, where the admission date is on record), free_consultation_first, published_fees_first or availability_reported_first. Equal listings keep a fixed shuffle. The order never says one lawyer is better.",
"type": "string",
"enum": [
"nearest_office",
"last_name",
"years_licensed",
"free_consultation_first",
"published_fees_first",
"availability_reported_first"
]
},
"verbosity": {
"description": "compact (default): shared notes once at the top and each lawyer's own facts; full adds every source detail per lawyer",
"type": "string",
"enum": [
"compact",
"full"
]
},
"introduction_ready_only": {
"description": "Deprecated since 2026-11-04 and ignored. Every listed lawyer is shown and can be contacted the same way.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}