# Ailalawyer — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and find immigration lawyers on AilaLawyer.com by location, language, and specialty, then view detailed profiles including their credentials and practice information. Easily browse through filtered results and discover the right legal expert for your immigration needs.

**Category:** Business Directories | **Website:** [ailalawyer.com/](https://ailalawyer.com/) | **Docs:** [parse.bot/marketplace/f6f1edd1-1773-4bc8-be68-ea9ee3bfa06a/ailalawyer-com-api](https://parse.bot/marketplace/f6f1edd1-1773-4bc8-be68-ea9ee3bfa06a/ailalawyer-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ailalawyer/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get form options

Retrieve all available filter options for the lawyer search form: US states, Canadian provinces, countries, languages, and practice areas. Each option contains a value (ID to pass to search_lawyers) and a human-readable label. Practice areas may be empty if the site does not expose them on the homepage form.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ailalawyer/get-form-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get lawyer details

Retrieve the full profile for a specific immigration lawyer by attorney and firm IDs (obtained from search_lawyers results). Returns name, firm, address, phone, website, law school, AILA membership year, bar admissions, practice areas, and languages spoken.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `a` | string | Yes | Attorney ID from search_lawyers results[*].a. |
| `p` | string | Yes | Firm ID from search_lawyers results[*].p. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ailalawyer/get-lawyer-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"a":"<string>","p":"<string>"}'
```

### Search lawyers

Search for immigration lawyers by location, language, and practice area. Returns the first page of up to 25 results with pagination metadata (current_page, total_pages, total_count). At least one filter should be provided; common patterns include searching by state, ZIP code, or last name. Results are randomized by the server on each request.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name to search in. |
| `country` | string | No | Country ID from get_form_options countries[*].value. |
| `language` | string | No | Language ID from get_form_options languages[*].value. 0 means any language. |
| `last` | string | No | Lawyer last name to search for. |
| `miles` | string | No | Search radius in miles from the specified location. |
| `practice` | string | No | Practice area ID from get_form_options practice_areas[*].value. |
| `state` | string | No | State ID from get_form_options states[*].value. |
| `zip` | string | No | US ZIP code (5 digits, leading zeros preserved). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ailalawyer/search-lawyers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","country":"<string>","language":"<string>","last":"<string>","miles":"<string>","practice":"<string>","state":"<string>","zip":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.