--- title: "Get Person Search Status" method: GET path: "/person_searches/{id}/status" tags: ["Person Search"] --- # Get Person Search Status `GET /person_searches/{id}/status` ## Path parameters - `id` string, uuid, required ## Response `200` Successful Response - V1PersonSearchStatusResponse — Represents a search status response. - `id` string, uuid, required — Unique identifier for the search. - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required - `error` string, nullable — Any errors that occurred. - `warnings` string[] — Any warnings that occurred. - `person` V1PersonResponse, required - `id` string, uuid, required — The unique identifier of the person - `first_name` string, required — The first name of the person - `last_name` string, required — The last name of the person - `ssn` string, required — The social security number of the person - `middle_name` string, nullable — The middle name of the person - `phone_number` string, nullable — The phone number of the person in E164 format - `email` string, nullable — The email address of the person - `date_of_birth` string, date, nullable — The date of birth of the person - `gender` 'M' | 'F' - `marital_status` 'married' | 'single' | 'divorced' | 'widowed' | 'separated' | 'domestic_partner' | 'civil_union' | 'other' - `suffix` string, nullable — The suffix of the person - `title` string, nullable — The title of the person - `created_at` string, date-time, required — When the person record was created - `updated_at` string, date-time, nullable — When the person record was last updated - `dockets` V1DocketResponse[] — The dockets associated with the person - `id` string, uuid, required — ID of the docket - `docket_number` string, required — Unique identifier for the Docket in the given court system - `court` string, required — Court in which the docket was filed - `state` 'US' | 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'CN' | 'VI' | 'AE' | 'AA' | 'AP' | 'MX' - `division` string, nullable — Which court division - `judges` string[] — List of judges assigned to the docket - `title` string, required — Title of the docket - `case_type` string, nullable — Type of case - `status` string, nullable — Status of the case - `is_bankruptcy` boolean, required — Is the case a bankruptcy - `bankruptcy_type` 'Chapter 7' | 'Chapter 11' | 'Chapter 12' | 'Chapter 13' | 'Chapter 15' - `date_filed` string, date — Date the case was filed. In cases where the date is not provided, this will be set to 1900-01-01. - `last_synced_at` string, date-time, nullable — Datetime the case was last refreshed - `parties` V1DocketParty[] — List of parties involved in the docket - `id` string, uuid, required — The unique identifier of the docket party. - `name` string, required — The name of the docket party. - `party_type` string, nullable — Type of party - `counsel` string[] — List of counsel representing the party - `updates` V1DocketUpdate[] — List of updates to the docket - `id` string, uuid, required — ID of the litigation - `title` string, nullable — Update title - `contents` string, nullable — Update contents - `date` string, date, nullable — Update date - `exhibits` V1DocketExhibit[] — List of exhibits - `id` string, uuid, required — ID of the litigation - `title` string, required — Exhibit title - `is_available` boolean — Is the exhibit available - `document_url` string, nullable, required — The document_url is a string that represents Docket Exhibit's document URL. - `match_level` 'NO_MATCH' | 'SIMILAR' | 'EXACT' - `search_entity_name` string, nullable — The name of the entity that the docket matched to - `search_entity_type` 'Business' | 'Person' - `risk_level` 'high' | 'medium' | 'low' | 'no_risk' - `normalized_status` 'open' | 'closed' - `liens` V1LienFilingResponse[] — The liens associated with the person - `id` string, uuid, required — The identifier of this lien filing record. - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS', required - `filing_number` string, required — Sequential identifier assigned by the filing office. - `filing_type` string, required — Describes the nature of the filing. - `filing_date` string, date, required — Official date when the lien was recorded. - `lapse_date` string, date, required — The expiry date for the lien's claim on collateral. - `status` string, required — Reflects the current legal status of the lien. - `number_of_pages` integer, required — Reflects the volume of documentation for the lien filing. - `document_filename` string, nullable — When present, it indicates that a document is available for download; Use get_lien_filing_documents or get_lien_filing_documents_for_business_id to download the documents. - `parties` V1LienPartyResponse[] — A list of parties associated with this lien filing, encompassing both debtors and secured parties. This relationship is critical for identifying all entities with a vested interest in the lien's terms and outcome. - `id` string, uuid, required — The identifier of this lien filing record. - `role` 'Debtor' | 'Secured Party' | 'Record Owner', required — Enum class delineating the role of parties in a lien transaction as defined by the UCC. - `name` string, required — Legal name of the party; crucial for due diligence and legal proceedings related to the lien. - `address` V1AddressSummaryResponse, required — Response model for address summary data. This model defines the structure for address summary API responses. - `id` string, uuid, required — Unique identifier for the address. - `street` string, required — Street name of the address. - `city` string, required — City name of the address. - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS', required - `zip` string, required — Zip code of the address. - `latitude` number, required — Latitude of the address. - `longitude` number, required — Longitude of the address. - `rdi` 'Residential' | 'Commercial' - `deliverable` boolean, nullable — Indicates whether the address is deliverable. - `cmra` boolean, nullable — Indicates whether the address is a Commercial Mail Receiving Agency (CMRA). - `url` string, uri, nullable — The URL to the address details. - `delivery_type` 'FIRM' | 'GENERAL_DELIVERY' | 'HIGH_RISE' | 'POST_OFFICE' | 'RURAL_ROUTE' | 'STREET' — Enum representing the different types of USPS delivery points. Used to classify addresses based on how mail is delivered to them. - `type` string, required — The type of lien party, indicating whether the party is an individual or an organization. A computed property that returns the role of the lien party. Note: This `type` property is planned to be deprecated in favor of the `role` field in future versions. - `amendments` V1LienAmendmentResponse[] — A chronological list of amendments to this lien filing, detailing any continuations, terminations, or modifications. This historical record is fundamental for tracking the evolution and current standing of the lien. - `filing_number` string, required — The document filing number. - `filing_type` string, required — The document filing type. - `filing_date` string, date, required — The date of the lien filing. - `number_of_pages` integer, required — Number of image pages in the library for this filing number. - `collateral_statements` V1LienCollateralStatementResponse[] — A sequence of collateral statements associated with this lien filing, enumerating the specific assets secured by the lien. The order of these statements can denote the priority of claims against the assets. - `text` string, required — A detailed description of the collateral that is subject to the lien. - `sort_order` integer, required — An integer representing the display or priority order of the collateral statements. - `last_updated_at` string, date, required — The date the lien filing record was last updated. - `match_level` 'NO_MATCH' | 'SIMILAR' | 'EXACT' - `search_entity_name` string, nullable — The name of the entity that the lien filing matched to. - `search_entity_type` 'Business' | 'Person' - `watchlist_hits` V1WatchlistHitResponse[] — The watchlist hits associated with the person. - `code` string, required — The code of the watchlist data source. - `name` 'Death Master File' | 'Department of Treasury, Office of Foreign Assets Control' | 'Politically Exposed Persons' | 'IRS Exempt Organizations List' | 'FBI Wanted List' | 'Department of Commerce, Consolidated Screening List' | 'Consolidated Canadian Autonomous Sanctions List' | 'HHS OIG List of Excluded Individuals/Entities' | 'Baselayer Fraud Consortium', required - `count` integer, required — The number of hits found in the watchlist data source. - `details` object[], nullable — The details of the watchlist hits. ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)