{ "openapi": "3.0.1", "info": { "title": "US Attorney Database & Lawyer Leads — Good Standing", "description": "US attorney database and lawyer leads: every licensed lawyer in 16 states, the state bars and top attorney directories merged into one profile. 1.47M lawyers with licence status, attorney discipline, firm, phone and email. Attorney license lookup by bar number, or filter by state and practice area.", "version": "1.0", "x-build-id": "KZHHmZ2qWYBOdsfsw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~good-standing-us-attorney-database/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-good-standing-us-attorney-database", "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/jungle_synthesizer~good-standing-us-attorney-database/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-good-standing-us-attorney-database", "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/jungle_synthesizer~good-standing-us-attorney-database/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-good-standing-us-attorney-database", "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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "resumeCursor": { "title": "Resume cursor (continue a previous run)", "type": "string", "description": "Leave empty for a fresh run. To CONTINUE a previous run without paying again for records you already received, paste the `resumeCursor` value from that run's Output (the run's OUTPUT key), with the same filters. It has no effect when you look up specific records." }, "states": { "title": "Licensed in (states)", "type": "array", "description": "The state bars that licensed them. Leave empty for every state we cover.", "items": { "type": "string", "enum": [ "AZ", "CA", "CO", "CT", "GA", "ID", "IN", "ME", "MN", "NY", "OH", "OR", "PA", "TX", "WI", "WY" ], "enumTitles": [ "Arizona (AZ)", "California (CA)", "Colorado (CO)", "Connecticut (CT)", "Georgia (GA)", "Idaho (ID)", "Indiana (IN)", "Maine (ME)", "Minnesota (MN)", "New York (NY)", "Ohio (OH)", "Oregon (OR)", "Pennsylvania (PA)", "Texas (TX)", "Wisconsin (WI)", "Wyoming (WY)" ] } }, "practiceAreas": { "title": "Practice areas", "type": "array", "description": "What they practise. Pick several to get attorneys in any of them. Only attorneys with a known practice area match.", "items": { "type": "string", "enum": [ "administrative", "antitrust", "appeals", "adr", "transportation", "banking", "bankruptcy", "business", "civil_rights", "construction", "consumer", "criminal", "education", "elder", "employment", "energy", "entertainment", "environmental", "estate", "family", "general", "health", "immigration", "insurance", "ip", "international", "litigation", "malpractice", "maritime", "personal_injury", "products_liability", "real_estate", "securities", "social_security", "tax", "technology", "workers_comp" ], "enumTitles": [ "Administrative & government", "Antitrust & competition", "Appeals", "Arbitration & mediation", "Aviation & transportation", "Banking & finance", "Bankruptcy & debt", "Business & corporate", "Civil rights & discrimination", "Construction", "Consumer protection", "Criminal defense", "Education", "Elder law", "Employment & labor", "Energy & natural resources", "Entertainment, media & sports", "Environmental", "Estate planning, wills & probate", "Family law & divorce", "General practice", "Health care", "Immigration", "Insurance", "Intellectual property", "International & trade", "Litigation & trials", "Malpractice & professional ethics", "Maritime & admiralty", "Personal injury & accidents", "Product liability", "Real estate & property", "Securities & investment", "Social security, disability & veterans", "Tax", "Technology & privacy", "Workers' compensation" ] } }, "admittedAfter": { "title": "Admitted in or after (year)", "type": "integer", "description": "Newer attorneys: e.g. 2018 for anyone admitted 2018 or later." }, "admittedBefore": { "title": "Admitted in or before (year)", "type": "integer", "description": "Senior attorneys: e.g. 2000 for anyone admitted in 2000 or earlier. Combine with the field above for a range." }, "firmNames": { "title": "Firms and employers", "type": "array", "description": "Part of a firm or employer name, e.g. Latham or Public Defender. Matches where they work now and, where we have their history, where they worked before. Several entries mean any of them.", "items": { "type": "string" } }, "lawSchools": { "title": "Law schools", "type": "array", "description": "Part of the law school name, e.g. Harvard or Hastings. Several entries mean any of them.", "items": { "type": "string" } }, "city": { "title": "Cities", "type": "array", "description": "City of their office or address of record, e.g. Los Angeles. Exact city name, any case. Several entries mean any of them.", "items": { "type": "string" } }, "county": { "title": "Counties", "type": "array", "description": "County of their address, e.g. Orange. Several entries mean any of them.", "items": { "type": "string" } }, "zip": { "title": "ZIP codes", "type": "array", "description": "5-digit ZIP codes of their address. ZIP+4 works too. Several entries mean any of them.", "items": { "type": "string" } }, "requireContact": { "title": "Must have a phone or an email", "type": "boolean", "description": "On by default, so you only pay for attorneys you can reach. Turn it off for compliance work, where the licence itself is the answer.", "default": true }, "requirePhone": { "title": "Must have a phone number", "type": "boolean", "description": "", "default": false }, "requireEmail": { "title": "Must have an email address", "type": "boolean", "description": "", "default": false }, "requireWebsite": { "title": "Must have a website", "type": "boolean", "description": "Their own or their firm's website.", "default": false }, "eligibleOnly": { "title": "Only attorneys allowed to practise", "type": "boolean", "description": "On by default, so you get working attorneys only. Turn it off to include suspended, disbarred, retired and deceased attorneys, e.g. for a compliance or panel screen.", "default": true }, "hasDisciplinaryHistory": { "title": "Disciplinary history", "enum": [ "any", "with", "without" ], "type": "string", "description": "Public disciplinary actions by the state bar, such as suspension, probation or reproval.", "default": "any" }, "names": { "title": "Names", "type": "array", "description": "Part of an attorney's name, e.g. Smith or Maria Lopez. Case doesn't matter. Several entries mean any of them. Works together with every other filter.", "items": { "type": "string" } }, "barNumbers": { "title": "Bar numbers", "type": "array", "description": "Already know who you want? List their bar numbers and set 'Licensed in' to the issuing state(s), since a number is only unique within its state. The run returns exactly those attorneys, whatever their status, and ignores every other filter.", "items": { "type": "string" } }, "emails": { "title": "Email addresses", "type": "array", "description": "Find attorneys by their exact email address. Ignores every other filter.", "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "How many attorneys to return at most. 0 means no limit; a whole state can run to six figures, so check the price first.", "default": 100 }, "includeSources": { "title": "Include sources", "type": "boolean", "description": "On by default: each field lists where its value came from (state bar, directory, or enriched). Turn it off for a simpler record with just the values.", "default": true }, "addedSince": { "title": "Only attorneys added in", "enum": [ "1 month", "2 months", "3 months", "6 months", "12 months" ], "type": "string", "description": "Only newly licensed or newly listed attorneys. Leave empty for everyone. On a monthly schedule, pick the last month to receive only the attorneys you have not seen." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }