{ "openapi": "3.0.1", "info": { "title": "State Bar [$1💰] Lawyer & Attorney License Verification", "description": "💰$1 per 1,000 results. Verify US attorneys against their state bar's official roster. Look up name, license status (Active/Inactive/Resigned/Disbarred), bar #, city, admission date — sourced directly from the state bar. v1: California (~250k attorneys). 14 filters. JSON/CSV out, billed per result.", "version": "0.0", "x-build-id": "siyj5ANJm7vLjNe3l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~us-state-bar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-us-state-bar-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/memo23~us-state-bar-scraper/runs": { "post": { "operationId": "runs-sync-memo23-us-state-bar-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/memo23~us-state-bar-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-us-state-bar-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "state": { "title": "State", "enum": [ "CA" ], "type": "string", "description": "Which state bar to search. Each state has its own search backend with different supported filters; the actor dispatches to the matching adapter. More states are added incrementally — request a state via the support email if it's not yet listed." }, "barNumber": { "title": "Bar number", "type": "string", "description": "Look up a single attorney by their California State Bar registration number (example: `200000` returns attorney Joanna Lynn Grisinger). ⚠️ **Degraded path**: returns a row with name + bar # + profile URL only — no status, city, or admission date. California's detail page is JS-rendered, so we extract only what's in the server-rendered `` tag. For full data, search by name instead." }, "freeText": { "title": "Free-text query (typically a name)", "type": "string", "description": "Free-text name search. The simplest entry point — works for partial or full names. Examples: `Smith`, `Garcia`, `Aaron Smith`. On California this maps to the QuickSearch FreeText field. ⚠️ Doesn't accept bar numbers — use the Bar number field for that." }, "lastName": { "title": "Last name", "type": "string", "description": "Last-name filter (example: `Smith`, `Chen`, `O'Connor`). Combined with the **Sounds-like** toggle: off (default) → begins-with match; on → phonetic match (e.g. \"Smith\" also matches \"Smyth\")." }, "firstName": { "title": "First name", "type": "string", "description": "First-name filter (example: `Aaron`, `Maria`). Same match-mode rule as last name." }, "middleName": { "title": "Middle name", "type": "string", "description": "Middle-name filter (example: `Patrick`)." }, "firmName": { "title": "Firm name", "type": "string", "description": "Firm-name filter (example: `Latham & Watkins` or just `Latham`)." }, "city": { "title": "City", "type": "string", "description": "Registered office city (example: `Los Angeles`, `San Francisco`, `Berkeley`)." }, "addressState": { "title": "Registered address state (2-letter)", "type": "string", "description": "2-letter US state code on the attorney's *registered address* (example: `NY`, `TX`). Useful for finding California-licensed attorneys whose office is registered out-of-state." }, "zip": { "title": "Registered address zip", "type": "string", "description": "5-digit US zip code (example: `94612`, `90012`)." }, "soundsLike": { "title": "Sounds-like / phonetic match", "type": "boolean", "description": "When enabled, the state adapter switches its name match-mode to a phonetic / sounds-like match (e.g. \"Smith\" also matches \"Smyth\"). Off by default (begin-with match).", "default": false }, "district": { "title": "California district", "enum": [ "", "1", "2", "3", "4", "5", "6", "0" ], "type": "string", "description": "California State Bar district (example: `District 5` for Los Angeles area). 8 options.", "default": "" }, "county": { "title": "California county", "enum": [ "", "**", "ZZ", "AL", "AP", "AM", "BU", "CA", "CO", "CC", "DN", "ED", "FR", "GL", "HM", "IM", "IN", "KN", "KI", "LK", "LS", "LA", "MA", "MR", "MP", "MN", "MC", "MD", "MO", "MT", "NP", "NV", "OR", "PL", "PM", "RV", "SA", "SO", "SR", "SD", "SF", "SJ", "SP", "SM", "SB", "SC", "SZ", "SH", "SI", "SK", "SL", "SN", "ST", "SU", "TE", "TR", "TU", "TL", "VN", "YO", "YU" ], "type": "string", "description": "California county (example: `Los Angeles`, `San Francisco`, `Alameda`). 60 options including \"Statewide\" and \"Non-California\".", "default": "" }, "legalSpecialty": { "title": "Certified legal specialty", "enum": [ "", "10", "08", "07", "101", "102", "103", "104", "01", "105", "106", "06", "04", "107", "09", "05", "111", "11", "109", "110", "112", "03", "02" ], "type": "string", "description": "Certified legal specialty — formal credentials granted by the State Bar (example: `Family Law`, `Bankruptcy Law`, `Criminal Trial Advocacy*`). 22 options. Asterisk-marked entries are sub-specialties. Use this for credentialed-attorney search.", "default": "" }, "languageSpoken": { "title": "Language spoken", "enum": [ "", "6", "50", "51", "49", "7", "8", "9", "52", "53", "54", "55", "48", "56", "10", "39", "57", "58", "59", "60", "61", "43", "62", "41", "63", "11", "64", "44", "12", "65", "13", "14", "15", "66", "16", "17", "18", "19", "45", "67", "68", "69", "20", "70", "21", "71", "72", "5", "73", "22", "74", "75", "76", "77", "2", "78", "79", "80", "81", "23", "82", "46", "83", "84", "85", "86", "87", "24", "25", "26", "27", "42", "28", "29", "30", "88", "31", "89", "90", "91", "92", "32", "1", "93", "47", "94", "3", "40", "33", "34", "35", "95", "96", "97", "36", "98", "37", "99", "4", "38" ], "type": "string", "description": "Language the attorney speaks (example: `Mandarin`, `Spanish`, `American Sign Language (ASL)`, `Arabic`). 99 options. Useful for finding multilingual attorneys for non-English-speaking clients.", "default": "" }, "practiceArea": { "title": "Practice area", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "65", "34", "35", "36", "37", "38", "39", "40", "41", "42", "66", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64" ], "type": "string", "description": "Practice area — broader self-reported categorization (example: `Real Estate`, `Family Law`, `Internet Law`). 66 options. Use this for everyday \"what does this lawyer do\" search; use Certified legal specialty above for credentialed search.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on rows. ⚠️ California's search caps at 500 results per query (no pagination is available). If a query returns 500, you've hit the cap — narrow your filters to get a different subset. Default 1000 lets the actor consume any single query without throttling.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of pages processed in parallel.", "default": 5 }, "minConcurrency": { "title": "Min concurrency", "minimum": 1, "type": "integer", "description": "Minimum number of pages processed in parallel.", "default": 1 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Number of retries before a failed request is given up.", "default": 5 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Most state bars don't have aggressive anti-bot — a small US-residential pool is plenty.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }