# Bankruptcies

Returns information about the bankruptcy records of a person.
<details>
<summary>Click here for fieldsets</summary>
#### Table
`BankruptcyID` `BankruptcyCaseNumber` `BankruptcyRecordingDate` `BankruptcyChapter` `BankruptcyStatus`
</details>

Endpoint: GET /v1/persons/{PersonKey}/bankruptcies
Version: 5.2.1.0
Security: api_key_bearer, x_radar_access_token

## Path parameters:

  - `PersonKey` (string, required)
    A unique identifier for the person.

## Query parameters:

  - `Fields` (array)
    A list of fields or fieldsets the client would like returned from the service.  Fields can be suppressed by prepending "-"

  - `Limit` (integer)
    Maximum number of records to return.

  - `Start` (integer)
    Offset from which to begin returning records. Used for paging.

  - `Purchase` (integer, required)
    Calls to this endpoint are charged per record returned.  To get a preview of the cost, set Purchase=0.  If Purchase is set to '1' or 'true', you will be charged against your balance for each record returned according to the terms of your subscription package. Charges are non-refundable.

## Response 200 fields (application/json):

  - `results` (array)

  - `results.PersonKey` (string)
    A unique identifier for the person.
    Example: p123123

  - `results.BankruptcyID` (integer)
    A unique identifier for the bankruptcy.
    Example: 823

  - `results.BankruptcyCaseNumber` (string)
    Unique case # tied to each Bankruptcy hearing.
    Example: 92685-JAC7

  - `results.BankruptcyRecordingDate` (string)
    The date the document was recorded at the county recorder's office.
    Example: 2023-06-29

  - `results.BankruptcyChapter` (string)
    The chapter of the bankruptcy code under which the bankruptcy case has been filed.
    Enum: "Chapter 7", "Chapter 11", "Chapter 12", "Chapter 13", "Chapter 15"

  - `results.BankruptcyStatus` (string)
    The current status of the bankruptcy case.
    Enum: "Discharged", "Dismissed", "Closed", "Open", "Converted", "Transferred", "Outdated"

  - `results.BankruptcyDistrict` (string)
    The federal judicial district the bankruptcy was filed in.
    Example: California Central

  - `results.BankruptcyJudgeName` (string)
    Name of the judge presiding over the bankruptcy case.
    Example: SCOTT H YUN

  - `results.BankruptcyProSe` (integer)
    Indicates whether the debtor is representing themselves in the bankruptcy case without an attorney.
    Enum: 0, 1

  - `results.BankruptcyAsset` (integer)
    Indicates whether the bankruptcy case involves significant assets.
    Enum: 0, 1

  - `results.BankruptcyDismissedDate` (string)
    The date on which the bankruptcy case was dismissed by the court.
    Example: 1984-01-24

  - `results.BankruptcyDischargedDate` (string)
    Date when the bankruptcy court officially relieves the debtor of their dischargeable debts.
    Example: 1984-01-24

  - `results.BankruptcyClosedDate` (string)
    The date when the bankruptcy case is officially closed by the court.
    Example: 1984-01-24

  - `results.BankruptcyTransferredDate` (string)
    Date when the bankruptcy case was transferred from one court jurisdiction to another.
    Example: 1984-01-24

  - `results.BankruptcyConversionDate` (string)
    Date on which a bankruptcy case was converted from one chapter to another.
    Example: 1984-01-24

  - `results.BankruptcyReliefFromStayDate` (string)
    Date when the court grants a creditor's request to lift the automatic stay, allowing the creditor to proceed with collection actions.
    Example: 1984-01-24

  - `results.BankruptcyAttorneyName` (string)
    Name of the attorney representing the debtor in the bankruptcy case.
    Example: PHILIP JOHNSON

  - `results.BankruptcyAttorneyFirm` (string)
    The law firm where the attorney representing the bankruptcy case.
    Example: LAW OFFICES OF PHILLIP

  - `results.BankruptcyAttorneyPhone` (string)
    The contact phone number of the attorney.
    Example: 8005551212

  - `results.BankruptcyTrusteeName` (string)
    Name of the trustee appointed in the bankruptcy case.
    Example: ANTHONY FIELD

  - `results.BankruptcyTrusteePhone` (string)
    The contact phone number of the trustee.
    Example: 8005551212

  - `totalCost` (string)
    The total amount billed for the records in this response
    Example: 1.00

  - `quantityFreeRemaining` (integer)
    Export credits remaining in the account. Only present for preview (Purchase=false) responses.
    Example: 250

  - `resultCount` (integer)
    The number of records in this response
    Example: 20

## Response 400 fields (application/json):

  - `error` (string)
    A simple explanation of the problem.  Not for display to end users.

  - `eventid` (string)
    A code in the form xxx-xxx-xxx that can be used for troubleshooting. Also present in headers as X-Radar-Request-Id
    Example: abc-123-def

  - `message` (string)
    If present, an explanation suitable for display to end users

  - `messageTitle` (string)
    If present, a title suitable for display to end users

## Response 402 fields (application/json):

  - `error` (string)
    A simple explanation of the problem.  Not for display to end users.
    Example: Insufficient Balance

  - `eventid` (string)
    A code in the form xxx-xxx-xxx that can be used for troubleshooting. Also present in headers as X-Radar-Request-Id
    Example: abc-123-def

  - `message` (string)
    An explanation suitable for display to end users
    Example: Your account balance is insufficient to process this request. Log in at app.propertyradar.com to Add to Balance, and consider changing your Low Balance Notification and Auto Recharge settings

  - `messageTitle` (string)
    A title suitable for display to end users
    Example: Sorry, Insufficient Balance

## Response 403 fields (application/json):

  - `error` (string)
    A simple explanation of the problem. Not for display to end users. OAuth denials often use the form `{error_code} - {description}` (for example, `access_denied - ...`). Permission denials typically return `You are not authorized to use this service.`
    Example: You are not authorized to use this service.

  - `eventid` (string)
    A code in the form xxx-xxx-xxx that can be used for troubleshooting. Also present in headers as X-Radar-Request-Id
    Example: abc-123-def

  - `message` (string)
    If present, an explanation suitable for display to end users

  - `messageTitle` (string)
    If present, a title suitable for display to end users

## Response 404 fields (application/json):

  - `error` (string)
    A simple explanation of the problem. Not for display to end users. Resource-not-found errors typically return `Resource does not exist for given id`. Unknown paths or missing authentication may return a message indicating the path was not found or authentication is missing.
    Example: Resource does not exist for given id

  - `eventid` (string)
    A code in the form xxx-xxx-xxx that can be used for troubleshooting. Also present in headers as X-Radar-Request-Id
    Example: abc-123-def

  - `message` (string)
    If present, an explanation suitable for display to end users

  - `messageTitle` (string)
    If present, a title suitable for display to end users