# Bankruptcies

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

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

## Security:

  - `api_key_bearer` (unknown)
    http bearer

  - `x_radar_access_token` (unknown)
    apiKey in header 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:

  - `200` (unknown)
    Success

## 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:

  - `400` (unknown)
    Bad request

## 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:

  - `402` (unknown)
    Insufficient Balance. Returned when the account balance is too low to cover the cost of the purchase this request would incur (i.e. when the request charges for records and `Purchase=1`). Add to your balance to retry; an unpaid cost quote can be obtained with `Purchase=0`.

## 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:

  - `403` (unknown)
    Forbidden. Returned when the access token is valid but the request is denied for authorization reasons. Common cases include an inactive subscription, a missing API or Integrations entitlement, insufficient OAuth scope, or lacking permission for the requested operation. Invalid or expired tokens return 401 instead.

## 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:

  - `404` (unknown)
    Not found. Returned when the requested path is unknown, authentication is missing (some routes return 404 rather than 401 to avoid revealing route existence), or a path parameter identifies a resource that does not exist or is not visible to the authenticated account (for example, an invalid RadarID or an ID belonging to another account). This replaces the previous behavior of returning 400 for resource-not-found errors.

## 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