[Skip to main content](https://developer.parallelmarkets.com/docs/server/data-structures/#__docusaurus_skipToContent_fallback)

Version: Current – v2.x

On this page

These are the JSON structures that are returned as API responses.

## General [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#general "Direct link to General")

### Location [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#location "Direct link to Location")

A particular place in the world.

| Name | Type | Description |
| --- | --- | --- |
| `address_one` | _string_ | Street address |
| `address_two` | _string_ | Second address line (apartment, suite, block, etc) |
| `city` | _string_ | Name of city |
| `region` | _string_ | Region is available for non-US addresses |
| `postal_code` | _string_ | A postal code (this will be a zip code for a US-based address) |
| `state` | _string_ | State for US-based addresses |
| `country` | _string_ | Two-letter [ISO Alpha-2 Country Code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example "Direct link to Example")

```json
{

"address_one": "123 Fake St",

"address_two": "Apt 3",

"city": "New York",

"region": null,

"postal_code": "10011",

"state": "NY",

"country": "US"

}
```

### User Session [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#user-session "Direct link to User Session")

Metadata about a web session that interacted with parallelmarkets.com

| Name | Type | Description |
| --- | --- | --- |
| `maybe_anonymizing_proxy` | _boolean_ | `true` if the user did use an anonymizing proxy (e.g. TOR, Public VPN) when submitting linked information. |
| `country_code` | _string_ | An alpha-2 ISO 3166 string indicating the country in which the user appeared to be when submitting linked information. Null if unknown. |
| `region` | _string_ | A string listing the name of the state or region in which the user appeared to be when submitting linked information. Null if unknown. |
| `city` | _string_ | A string listing the name of the city in which the user appeared to be when submitting linked information. Null if unknown. |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-1 "Direct link to Example")

```json
{

"maybe_anonymizing_proxy": false,

"country_code": "US",

"region": "North Carolina",

"city": "Durham"

}
```

### Dates and Timestamps [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#dates-and-timestamps "Direct link to Dates and Timestamps")

All date and date time (aka, timestamp) information is provided in standard [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. Dates will be provided as `YYYY-MM-DD` strings (i.e., "2021-06-10"). Timestamps will be provided as string UTC dates with time in the format `YYYY-MM-DDThh:mm:ssZ` (i.e., "2021-06-29T13:32:21Z").

## Case Management [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#case-management "Direct link to Case Management")

### Record [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record "Direct link to Record")

An individual or business linked to your case management instance.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | Unique ID of the record. This can be used to uniquely identify a particular record when calling the API endpoints, or can be used to navigate to the record details page on the dashboard for this particular record.<br>For dashboard navigation, the following URL can be used to redirect to the record details page if the current user is authorized to view the record: `https://app.parallelmarkets.com/id/{id}` |
| `type` | _string_ | The type of record. Can be `individual` or `business`. |
| `details` | _object_ | A [Business Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details) or [Individual Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-record-details) object depending on the type. _This attribute is not returned by any list endpoints, it is only returned by endpoints that return a single business or individual record._ |
| `traits` | _object\[\]_ | An array of configured [record traits](https://developer.parallelmarkets.com/docs/server/data-structures/#record-trait) with values (if there are any). |
| `identity_link_established_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the entity granted permissions to share their data. |
| `identity_link_expires_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the identity link will expire and updates to data will cease to be shared with the partner. |
| `identity_link_expiration_requested_by` | _string_ | Who requested the data link to be revoked. Can be one of:<br>- `subject` \- Access revocation requested by the subject of the record.<br>- `partner` \- Access revocation requested by the partner.<br>- `null` \- Access revocation has not been requested.<br>- `system` \- Access to this subject's data was revoked by our internal systems. |
| `current_status` | _object_ | An [Record Status](https://developer.parallelmarkets.com/docs/server/data-structures/#record-status) object. |
| `created_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the record was created. |
| `archived_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the record was archived. |
| `ref_code` | _string_ | The `ref_code` value provided when initiating the Parallel flow [via the SDK](https://developer.parallelmarkets.com/docs/javascript/sdk) or by providing a `ref_code` query string parameter to your Bridge Page URL. Will be `null` if no `ref_code` was provided. This value can only be set once based on the value in the first handoff. |
| `external_id` | _string_ | A custom unique identifier for this record. See [Using an External Identifier](https://developer.parallelmarkets.com/docs/server/case-management-api/records/create#using-an-external-identifier) for more information. |
| `risk_monitoring_status` | _string_ | The subject's current risk monitoring status. _This attribute is not returned by any list endpoints, it is only returned by endpoints that return a single business or individual record._ |
| `possible_or_likely_risk_match_count` | _number_ | The number of risk matches that were resolved as `possible-match` or `likely-match` if `risk_monitoring_status` is `enabled`, `null` otherwise. _This attribute is not returned by any list endpoints, it is only returned by endpoints that return a single business or individual record._ |
| `potential_risk_match_count` | _number_ | The number of unresolved risk matches if `risk_monitoring_status` is `enabled`, `null` otherwise. _This attribute is not returned by any list endpoints, it is only returned by endpoints that return a single business or individual record._ |
| `subject_last_submitted_identity_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the subject associated with the record most recently submitted their identity details. The value is `null` when the subject has never submitted their identity details. |

Risk monitoring statuses:

- `enabled` \- Risk monitoring is enabled and potential risk matches will be processed on an ongoing basis
- `disabled` \- Risk monitoring has been disabled for this individual
- `initiating` \- Risk monitoring for this individual is being configured

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-2 "Direct link to Example")

```json
{

"created_at": "2022-08-29T15:14:44Z",

"current_status": {

"notes": "This is a test note.",

"set_at": "2023-05-17T15:14:44Z",

"set_by": {

"email": "joe@acme.com",

"first_name": "Joe",

"last_name": "Bloggs"

},

"status": "approved"

},

"id": "UG9kVXNlclJlY29yZDoyNDQw",

"identity_link_established_at": "2022-08-29T15:14:44Z",

"identity_link_expiration_requested_by": null,

"identity_link_expires_at": null,

"type": "individual",

"external_id": "unique_external_id_123",

"user_deactivated_at": null,

"user_requested_deletion_at": null

}
```

### Record Comment [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record-comment "Direct link to Record Comment")

A comment for an individual or business entity record.

| Name | Type | Description |
| --- | --- | --- |
| `text` | _string_ | The text of the comment. |
| `created_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the comment was added. |
| `created_by` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) object containing information about the partner team member that added the comment; `null` if the comment is created via the API. |
| `source` | _string_ | The source that set the status. Can be one of:<br>- `api`<br>- `user` |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-3 "Direct link to Example")

```json
{

"text": "This is a test comment.",

"created_at": "2023-05-17T15:14:44Z",

"created_by": {

"email": "joe@acme.com",

"first_name": "Joe",

"last_name": "Bloggs"

},

"source": "user"

}
```

### Record Status [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record-status "Direct link to Record Status")

The current status of an individual or business entity.

| Name | Type | Description |
| --- | --- | --- |
| `status` | _string_ | The current status of the entity. Can be one of:<br>- `open`<br>- `pending`<br>- `approved`<br>- `declined` |
| `set_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the current status was set. |
| `set_by` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) object containing information about the partner team member that set the status. |
| `source` | _string_ | The source that set the status. Can be one of:<br>- `api`<br>- `system`<br>- `user` |
| `notes` | _string_ | Notes created for the entity by a partner team member. |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-4 "Direct link to Example")

```json
{

"notes": "This is a test note.",

"set_at": "2023-05-17T15:14:44Z",

"set_by": {

"email": "joe@acme.com",

"first_name": "Joe",

"last_name": "Bloggs"

},

"status": "approved",

"source": "user"

}
```

### Risk Match [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#risk-match "Direct link to Risk Match")

A risk match for an individual or business.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | Identifier for the specific risk match. |
| `change_id` | _string_ | Identifier for the specific record change entry that this risk match is associated with. |
| `created_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the risk match was created. |
| `match_details` | _object_ | An [Individual Risk Monitor Match](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-risk-monitor-match) or [Business Risk Monitor Match](https://developer.parallelmarkets.com/docs/server/data-structures/#business-risk-monitor-match) object. |
| `review_details` | _object_ | A [Risk Match Review Details](https://developer.parallelmarkets.com/docs/server/data-structures/#risk-match-review-details) object. _This attribute is not returned by all endpoints. It is only returned by the endpoint to retrieve a single business or individual risk match._ |
| `resolution_id` | _string_ | The identifier of the current resolution applied to the risk match. |
| `resolution` | _string_ | The current resolution status applied to the risk match by a partner team member. Can be one of:<br>- `name-mismatch`<br>- `nationality-mismatch`<br>- `birth-date-mismatch`<br>- `sex-mismatch`<br>- `facial-mismatch`<br>- `possible-match`<br>- `likely-match` |
| `resolution_notes` | _string_ | Notes provided by a partner team member when resolving the risk match. |
| `resolved_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) when the resolution was applied to the risk match by a partner team member. |
| `resolved_by` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) object of the partner team member that applied the resolution. |
| `source` | _string_ | The source that applied the resolution. Can be one of:<br>- `api`<br>- `system`<br>- `user` |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-5 "Direct link to Example")

```json
{

"change_id": "UG9kVXNlckRhdGFFbnRyeTo5NTA=",

"created_at": "2023-06-07T09:54:33Z",

"id": "VXNlclJpc2tNb25pdG9yTWF0Y2g6NDU=",

"match_details": {

"adverse_media": true,

"birth_date": "1957-03-10",

"currently_sanctioned": true,

"deceased": true,

"disqualified_director": false,

"financial_regulator": true,

"first_name": "Joe",

"insolvent": false,

"last_name": "Sanctioned",

"law_enforcement": true,

"middle_name": "PATRICK",

"nationalities": ["RU"],

"pep": true,

"previously_sanctioned": false,

"score": 100

},

"review_details": {

"aliases": [\
\
      {\
\
        "first_name": "Joseph",\
\
        "middle_name": "Patrick",\
\
        "last_name": "Sanctioned"\
\
      }\
\
    ],

"notes": [\
\
      "Listed as a sanctioned individual by the United States Office of Foreign Assets Control (OFAC)"\
\
    ],

"image_url": "https://ari-cdn.parallelmarkets.com/cdn/content/123.PNG",

"articles": [\
\
      {\
\
        "original_url": "https://example.com/123",\
\
        "archival_url": "https://example.com/123.pdf",\
\
        "date_collected": "2022-06-13",\
\
        "categories": ["Sanction (current)", "Insolvent"]\
\
      }\
\
    ],

"current_sanctions": ["Office of Foreign Assets Control (OFAC)"],

"former_sanctions": ["Japan Ministry of Finance"],

"pep_tier": "PEP Tier 2",

"addresses": [\
\
      {\
\
        "address_one": "11 11th st",\
\
        "address_two": "11L",\
\
        "city": "Brooklyn",\
\
        "country": "US",\
\
        "postal_code": "11201",\
\
        "region": null,\
\
        "state": "NY"\
\
      }\
\
    ]

},

"resolution": "likely-match",

"resolution_id": "UG9kVXNlclJpc2tNYXRjaDoxMTU=",

"resolution_notes": "Name, DOB, Nationality and picture indicate a likely match.",

"resolved_at": "2023-06-07T09:54:33Z",

"resolved_by": {

"email": "reviewer@acme.com",

"first_name": "John",

"last_name": "Reviewer"

},

"source": "user"

}
```

### Risk Match Review Details [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#risk-match-review-details "Direct link to Risk Match Review Details")

Information about a sanctioned (or otherwise risky) entity for review when determining the resolution of a potential match to an individual or business.

| Name | Type | Description |
| --- | --- | --- |
| `addresses` | _object\[\]_ | An array of [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) objects for associated addresses. |
| `articles` | _object\[\]_ | An array of [Risk Match Review Article](https://developer.parallelmarkets.com/docs/server/data-structures/#risk-match-review-article) objects. |
| `aliases` | _object\[\]_ | An array of objects containing alias information for the entity. <br>For individuals the object contains:<br>- `first_name`<br>- `middle_name`<br>- `last_name`<br> For businesses the object contains:<br>- `name` |
| `image_url` | _string_ | URL for the profile image of the entity, if one is available. |
| `notes` | _string\[\]_ | An array of notes on the entity. |
| `current_sanctions` | _string\[\]_ | An array of sanctioning bodies for the entity's current sanctions. |
| `former_sanctions` | _string\[\]_ | An array of sanctioning bodies for the entity's former sanctions. |
| `pep_tier` | _string_ | String indicating the entity's PEP tier. Only applicable for individuals who are considered a [Politically Exposed Person](https://en.wikipedia.org/wiki/Politically_exposed_person). |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-6 "Direct link to Example")

```json
{

"aliases": [\
\
    {\
\
      "first_name": "Joseph",\
\
      "middle_name": "Patrick",\
\
      "last_name": "Sanctioned"\
\
    }\
\
  ],

"notes": [\
\
    "Listed as a sanctioned individual by the United States Office of Foreign Assets Control (OFAC)"\
\
  ],

"image_url": "https://ari-cdn.parallelmarkets.com/cdn/content/123.PNG",

"current_sanctions": ["Office of Foreign Assets Control (OFAC)"],

"former_sanctions": ["Japan Ministry of Finance"],

"pep_tier": "PEP Tier 2",

}
```

### Risk Match Review Article [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#risk-match-review-article "Direct link to Risk Match Review Article")

Published information about a sanctioned (or otherwise risky) entity.

| Name | Type | Description |
| --- | --- | --- |
| `categories` | _string\[\]_ | An array of categorical tags applicable to the article. For example:<br>- `Sanction (current)`<br>- `Adverse Media`<br>- `Disqualified Director` |
| `date_collected` | _string_ | [Date](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the article was initially collected for review. |
| `original_url` | _string_ | URL for the article referencing the entity. |
| `archival_url` | _string_ | URL for the PDF version of the article, if available. |

### Individual Record Details [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-record-details "Direct link to Individual Record Details")

A record for an individual in the Case Management system.

| Name | Type | Description |
| --- | --- | --- |
| `birth_date` | _string_ | [Date](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) representing the individual's date of birth. |
| `birth_place` | _string_ | The individual's place of birth. |
| `citizenship_country` | _string_ | ISO Alpha-2 Country Code; The individual's country of citizenship. |
| `secondary_citizenship_countries` | _string\[\]_ | An array of two-letter [ISO Alpha-2 Country Code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes representing the individuals secondary countries of citizenship. |
| `domicile_location` | _object_ | A [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) for the individual's legal address, where they pay taxes. |
| `email` | _string_ | The individual's email address. |
| `first_name` | _string_ | The individual's provided legal first name. |
| `middle_name` | _string_ | The individual's provided legal middle name (if any). |
| `last_name` | _string_ | The individual's provided legal last name. |
| `name_suffix` | _string_ | The individual's name suffix (e.g., "Jr.", "Sr.", "III"). |
| `gender` | _string_ | The individual's gender. Can be one of:<br>- `male`<br>- `female`<br>- `other` |
| `marital_status` | _string_ | `single`, `married`, `separated` or `divorced`; The individual's marital status (if any). |
| `phone` | _string_ | The individual's provided phone number. Will be provided in standard [E.164](https://en.wikipedia.org/wiki/E.164) format with a country code prefix (i.e., "+12121234567"). |
| `residence_location` | _object_ | A [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) where the individual maintains a part or full-time residence. |
| `tax_id` | _string_ | The individual's tax id number. |
| `tax_country` | _string_ | The individual's tax country. |
| `secondary_tax_id` | _object\[\]_ | An array of [Secondary Tax ID](https://developer.parallelmarkets.com/docs/server/data-structures/#secondary-tax-id) object. |
| `us_person` | _boolean_ | Indicates whether the individual is a U.S. person for federal tax purposes (includes but not limited to an individual U.S. citizen or U.S. resident alien). Null if unknown. |
| `user_session` | _object_ | A [User Session](https://developer.parallelmarkets.com/docs/server/data-structures/#user-session) containing details about the session that provided this information. |
| `change_created_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the change was made. |
| `change_created_by` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) object of the individual who created the change. |
| `change_id` | _string_ | Identifier for the specific change entry. As individual records within Parallel Markets can change over time, this identifier can be used to obtain a snapshot of data associated with this identifier. |
| `source` | _string_ | The source of the change. Can be one of:<br>- `api`<br>- `system`<br>- `user` |
| `consistency_summary` | _object_ | The [Individual Consistency Summary](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-consistency-summary) results. |
| `indicated_unaccredited_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) indicating when the individual was marked unaccredited. |
| `accreditation_expires_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) at which the individual's accreditation expires. |
| `id_expiration` | _string_ | The expiration date of the individual's ID. |
| `accreditation_assertion_type` | _string_ | The assertion type used to determine the individuals accreditation status. A list of assertion types is provided below. |
| `accreditation_status` | _string_ | The individual's accreditation status. This will be one of "CURRENT", "EXPIRED", or `null`. See the [Accreditations API](https://developer.parallelmarkets.com/docs/server/case-management-api/accreditations/list) for the status of accreditation applications. |
| `risk_monitoring_status` | _string_ | The individual's risk monitoring status for the specific change entry. |
| `user_deactivated_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) when the user associated with the record was deactivated. A user can be deactivated if they submit a data deletion request, or, in rare cases, if they have violated Parallel's Terms of Service. |
| `user_requested_deletion_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) when the user associated with the record requested that Parallel stop sharing data updates with partners' Case Management systems. Copies of the individual's data that exist within partner owned Case Management areas on Parallel's systems won't be affected. See [the support article for data deletion requests](https://support.parallelmarkets.com/hc/en-us/articles/4417796314765-Privacy-FAQ#how-can-i-request-that-my-data-be-deleted) for more information. |

Assertion types:

- `income` \- Accreditation is based on the income test
- `net-worth` \- Accreditation is based on the net-worth test
- `evaluator-assertion` \- Accreditation is based on a third party evaluation (CPA, lawyer, or broker dealer reviewed accreditation status)
- `professional-license` \- The person holds a professional license that qualifies them for accreditation

Risk monitoring statuses:

### Business Record Details [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#business-record-details "Direct link to Business Record Details")

A record for a business in the Case Management system.

| Name | Type | Description |
| --- | --- | --- |
| `name` | _string_ | The business's provided legal name. |
| `business_type` | _object_ | See [Business Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#business-profile) for possible values. |
| `control_persons` | _object\[\]_ | An array of [Control Person](https://developer.parallelmarkets.com/docs/server/data-structures/#control-person) objects. |
| `beneficial_owners` | _object\[\]_ | An array of [Beneficial Owner](https://developer.parallelmarkets.com/docs/server/data-structures/#beneficial-owner) objects. |
| `incorporation_country` | _string_ | Two-letter [ISO Alpha-2 Country Code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) representing the business's country of incorporation. |
| `incorporation_region` | _string_ | The business's region of incorporation, if applicable `null` if incorporated in the United States. |
| `incorporation_state` | _string_ | Two-letter state code; The business's state of incorporation. `null` unless incorporated in the United States. |
| `primary_contact` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) for the primary contact for the business. |
| `principal_location` | _object_ | A [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) representing where the business primarily conducts its business. |
| `domicile_location` | _object_ | A [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) representing the business's legal domicile. |
| `accreditation_assertion_type` | _string_ | The assertion type used to determine the business's accreditation status. A list of assertion types is provided below. |
| `accreditation_status` | _string_ | The business' accreditation status. This will be one of "CURRENT", "EXPIRED", or `null`. See the [Accreditations API](https://developer.parallelmarkets.com/docs/server/case-management-api/accreditations/list) for the status of accreditation applications. |
| `indicated_unaccredited_at` | _string_ | The timestamp indicating when the business was marked unaccredited. |
| `accreditation_expires_at` | _string_ | The timestamp at which the business's accreditation expires. |
| `beneficial_ownership_threshold` | _number_ | The threshold used to determine beneficial ownership. Default value: 0.25 (25%). |
| `consistency_summary` | _object_ | The [Business Consistency Summary](https://developer.parallelmarkets.com/docs/server/data-structures/#business-consistency-summary) results. |
| `change_created_at` | _string_ | A timestamp of when the change was made. |
| `change_created_by` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) object of the individual who created the change. |
| `change_id` | _string_ | Identifier for the specific change entry. As business records within Parallel Markets can change over time, this identifier can be used to obtain a snapshot of data associated with this identifier. |
| `source` | _string_ | The source of the change. Can be one of:<br>- `api`<br>- `system`<br>- `user` |
| `tax_id` | _string_ | The business's provided tax id number (e.g. EIN). |
| `tax_country` | _string_ | The business's tax country. |
| `secondary_tax_id` | _object\[\]_ | An array of [Secondary Tax ID](https://developer.parallelmarkets.com/docs/server/data-structures/#secondary-tax-id) object. |
| `us_person` | _boolean_ | Indicates whether the business is a U.S. person for federal tax purposes (includes but is not limited to a partnership, corporation, company or association created or organized in the United States or under the laws of the United States; any estate (other than a foreign estate); or a domestic trust). Null if unknown. |
| `risk_monitoring_status` | _string_ | The business's risk monitoring status for the specific change entry. |

Assertion types:

- `worth` \- Accreditation is based on worth (only used for businesses)
- `evaluator-assertion` \- Accreditation is based on a third party evaluation (CPA, lawyer, or broker dealer reviewed accreditation status)
- `accredited-owners` \- Accreditation is based on all owners being accredited

Risk monitoring statuses:

- `enabled` \- Risk monitoring is enabled and potential risk matches will be processed on an ongoing basis
- `disabled` \- Risk monitoring has been disabled for this business
- `initiating` \- Risk monitoring for this business is being configured

### Record File [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record-file "Direct link to Record File")

A file associated with a Case Management record.

| Name | Type | Description |
| --- | --- | --- |
| `name` | _string_ | The file name (e.g., "document.pdf") provided when the file was uploaded. |
| `type` | _string_ | A "kebab-case" string representing the `id` of the [Record File Type](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file-type). This has no bearing on the `Content-Type` of the file. |
| `type_name` | _string_ | A "Title Case" string representing the name of the [Record File Type](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file-type). If `type` is `"other"`, then `type_name` will either be `"Other"` or a custom value for this file. |
| `category` | _string_ | One of `"accreditation-document"`, `"identity-document"` or `"general-document"` based on the `type` of the file. |
| `download_url` | _string_ | URL where the document is available. The URL includes a token that enables embedding of the document in a webpage (or a direct download with a `GET` request). |
| `download_url_expires` | _number_ | Number of seconds until the token in the `download_url` expires. |
| `change_id` | _string_ | Identifier for the specific [change entry](https://developer.parallelmarkets.com/docs/server/case-management-api/changes/list) the file is associated with, if any. As individual or business records within Parallel Markets can change over time, this identifier can be used to obtain a snapshot of data associated with this identifier. |
| `expires_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) representing when the document expires, if known. |
| `source` | _string_ | The source of the file. Can be one of: <br>- `api`<br>- `system`<br>- `user` |
| `created_at` | _string_ | [Timestamp](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) of when the file was added to the Case Management record. |
| `consistency_details` | _object_ | [Consistency details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-identity-document-consistency-details) for the file. _This attribute is only available for files returned as part of an [individual consistency summary](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-consistency-summary)._ |

### Record File Type [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record-file-type "Direct link to Record File Type")

An enumerated type used for [Record File](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) document classification.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | A unique "kebab-case" string representing the document type, suitable for use as an identifier or key. |
| `name` | _string_ | A "Title Cased" string representing the document type, suitable for display to end-users. |
| `category` | _string_ | One of `"accreditation-document"`, `"identity-document"` or `"general-document"`. |
| `description` | _string_ | A description of the document type. |

### Secondary Tax ID [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#secondary-tax-id "Direct link to Secondary Tax ID")

A secondary tax identification number for an individual or business.

| Name | Type | Description |
| --- | --- | --- |
| `tax_id` | _string_ | The secondary tax identification number for the individual or business. |
| `tax_country` | _string_ | A two-letter [ISO Alpha-2 Country Code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code representing the country associated with the individual's or business's secondary tax identification number. |

### Record Trait [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#record-trait "Direct link to Record Trait")

Record traits allow you, as a partner, to store custom attributes about an individual or business. You can read more about configuring record traits on [the partner support page](https://support.parallelmarkets.com/hc/en-us/articles/32394559104397-Record-Traits).

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | A unique "kebab-case" string representing the configured record trait. |
| `name` | _string_ | A string, representing the name of the configured trait. |
| `type` | _string_ | A string, representing the type of the configured trait. One of: <br>- `boolean`<br>- `date` (the value is served as _string_)<br>- `number` (the value is served as _string_)<br>- `string`<br>- `strings` (corresponds to the `multi-string` type in the [record trait configuration UI](https://support.parallelmarkets.com/hc/en-us/articles/32394559104397-Record-Traits)). |
| `value` | Varies based on `type`, one of: <br>- _boolean_<br>- _string_<br>- _string\[\]_ | Value of the configured trait for the given individual or business. If no value, then can be an empty array (`[]`) for multi-string (`strings`) type or `null` for all other types. |

note

We do not currently support programmatically configuring traits via the API. Traits can be configured in your partner dashboard.

### Accreditation Reviewer Note [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#accreditation-reviewer-note "Direct link to Accreditation Reviewer Note")

An object representing a current reviewer note for a given accreditation.

| Name | Type | Description |
| --- | --- | --- |
| `text` | _string_ | Content of the note |
| `created_at` | _string_ | Timestamp of when the note was created |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-7 "Direct link to Example")

```json
{

"text": "Waiting for additional documentation from subject.",

"created_at": "2023-09-01T16:00:00Z"

}
```

## Individual Data Structures [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-data-structures "Direct link to Individual Data Structures")

### Individual Profile [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-profile "Direct link to Individual Profile")

An individual person's profile details.

| Name | Type | Description |
| --- | --- | --- |
| `email` | _string_ | Person's email address (may be `null` based on permissions) |
| `first_name` | _string_ | First name of person |
| `last_name` | _string_ | Last name of person |

note

Note that the name used here is the current one the person has set in their profile settings, which may not be the same as their legal names used in accreditation or identity flows (the legal names in an [Individual Accreditation](https://developer.parallelmarkets.com/docs/server/data-structures/#cm-individual-accreditation) or [Individual Identity Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-record-details) response may be different).

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-8 "Direct link to Example")

```json
{

"email": "test@example.com",

"first_name": "Wyman",

"last_name": "Manderly"

}
```

### Individual Accreditation [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#cm-individual-accreditation "Direct link to Individual Accreditation")

An object representing an accreditation application by an individual.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | Unique identifier for the accreditation |
| `status` | _string_ | One of the statuses listed below |
| `assertion_type` | _string_ | One of the types listed below |
| `created_at` ( **Deprecated**) | _string_ | _Timestamp of when the accreditation application was submitted by the user. Note that `created_at` will be `null` if the user began but never finished their application._ |
| `submitted_at` | _string_ | Timestamp of when the accreditation application was submitted by the user. Note that `submitted_at` will be `null` if the user began but never finished their application. |
| `started_at` | _string_ | Timestamp of when the accreditation application was started by the user. |
| `certified_at` | _string_ | Timestamp of when the accreditation application was certified and accreditation certification letter was issued |
| `expires_at` | _string_ | Timestamp of when the accreditation certification letter expires |
| `rejected_at` | _string_ | Timestamp of when the accreditation application was rejected |
| `cancled_at` | _string_ | Timestamp of when the accreditation application was canceled |
| `first_name` | _string_ | The first name of the individual |
| `last_name` | _string_ | The last name of the individual |
| `documents` | _object\[\]_ | A list of Accreditation Document [Record Files](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) |
| `rejection_reason` | _string_ | One of the reasons listed below (if the accreditation is rejected) |
| `change_ids` | _string_ | Identifiers for the specific [change](https://developer.parallelmarkets.com/docs/server/case-management-api/changes/list) entries associated with the accreditation. |
| `reviewer_note` | _object_ | An [Accreditation Reviewer Note](https://developer.parallelmarkets.com/docs/server/data-structures/#accreditation-reviewer-note) regarding the accreditation. |

Accreditation application statuses:

- `current` \- Accreditation is currently valid
- `unsubmitted` \- Accreditation application has been started but not yet completed by the applicant
- `pending` \- Accreditation application is in review
- `submitter_pending` \- Accreditation application is awaiting additional information or documentation from the submitter
- `third_party_pending` \- Accreditation application is awaiting documentation from a third party evaluator
- `canceled` \- Accreditation application has been canceled due to submitter request or unresponsive third party evaluator
- `expired` \- Accreditation has expired and is no longer valid
- `rejected` \- Accreditation attempt was unsuccessful due to a failure to meet requirements

Assertion types:

Accreditation application rejection reasons:

- `expired-document` \- One or more documents have expired
- `mismatched-name` \- Name in document doesn't match applicant name
- `income-invalid` \- Income doesn't meet necessary threshold
- `net-worth-invalid` \- Net worth doesn't meet necessary threshold
- `wrong-document-type` \- Wrong document type submitted
- `evaluator-rejection` \- Individual's CPA/Lawyer/Investment Advisor declined to accredit
- `evaluator-letter-invalid` \- Letter wasn't dated within 90 days, didn't mention if docs were reviewed or was not from CPA/BD/Attorney
- `invalid-crd-number` \- CRD number is invalid

note

Note that the first and last name given here may not match the name in the user's current [Individual Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-record-details). The name given in the accreditation assertion is the name used at the time of accreditation, and the accreditation is only valid for the individual named. The name returned in the user's current [Individual Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-record-details) may have changed since the time of the accreditation.

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-9 "Direct link to Example")

```json
{

"assertion_type": "income",

"change_ids": ["UG9kVXNlckRhdGFFbnRyeTo5NTA="],

"created_at": "2023-09-01T12:00:00Z",

"submitted_at": "2023-09-01T12:00:00Z",

"started_at": "2023-09-01T16:00:00Z",

"certified_at": "2023-09-01T16:00:00Z",

"expires_at": "2023-11-01T16:00:00Z",

"rejected_at": null,

"canceled_at": null,

"id": "VXNlckFjY3JlZGl0YXRpb246MQ==",

"status": "current",

"first_name": "Snake",

"last_name": "Plissken",

"documents": [\
\
    {\
\
      "download_url": "https://api.parallelmarkets.com/files/123?token=abc123",\
\
      "download_url_expires": 30,\
\
      "type": "certification-letter"\
\
    }\
\
  ],

"reviewer_note": {

"text": "Waiting for additional documentation from subject.",

"created_at": "2023-09-01T16:00:00Z"

}

}
```

### Individual Consistency Summary [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-consistency-summary "Direct link to Individual Consistency Summary")

An object representing the consistency summary results for an individual.

| Name | Type | Description |
| --- | --- | --- |
| `address_id_match` | _boolean_ | `true` if we were able to detect an address on the individual's [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) (for example, a driver license) and it matches a submitted domicile or residence [location](https://developer.parallelmarkets.com/docs/server/data-structures/#location); `false` if the identity document address does not match either the domicile or residence location; `null` if we were unable to detect an address on the individual's identity document or if an identity document was not submitted |
| `address_id_value` | _string_ | The address we were able to detect on the individual's [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file); `null` if we were unable to detect an address on the submitted identity document or if an identity document was not submitted |
| `address_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted domicile and residence [locations](https://developer.parallelmarkets.com/docs/server/data-structures/#location) |
| `address_submitter_match` | _boolean_ | `true` if the submitter's location (detected from their IP address) matched either the domicile or residence [location](https://developer.parallelmarkets.com/docs/server/data-structures/#location), `false` otherwise |
| `birth_date_id_match` | _boolean_ | `true` if the individual's submitted date of birth matches the date of birth listed on the individual's submitted [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) (for example, a passport); `false` if the date of birth does not match; `null` if we were unable to detect a date of birth on the submitted identity document or if an identity document was not submitted |
| `birth_date_id_value` | _string_ | [Date](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) representing the submitted individual's date of birth detected on the individual's [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file); `null` if we were unable to detect a date of birth on the submitted identity document or if an identity document was not submitted |
| `birth_date_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted individual's date of birth; `null` if an identity document was not submitted |
| `id_selfie_similarity_level` | _string_ | One of the consistency levels (see below) representing the probability that the selfie photo and the photo on the Government ID are of the same person; `null` if selfie photo and/or Government ID were not collected or if we were unable to detect a face on the selfie photo |
| `id_validity` | _string_ | One of the submitted [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) validity results (see below); `null` if an identity document was not submitted |
| `id_matching_sides` | _boolean_ | `true` if there is more than one image from a government ID (say, front/back of a driver's license) and they all appear to be from the same ID; `false` if there is more than one image and discrepancies were found; `null` if there was only one side uploaded (for example, a passport) |
| `id_files` | _object\[\]_ | A list of [identity documents](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) used to determine the Government ID and selfie photo consistency summary results |
| `name_id_match` | _boolean_ | `true` if we were able to detect the individual's name on their identity document (for example, a passport) and it matches the submitted name; `false` if the identity document name does not match the submitted name; `null` if we were unable to detect a name on the submitted identity document or if an identity document was not submitted |
| `name_id_value` | _string_ | The submitted individual's name detected on the individual's [identity document](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file); `null` if we were unable to detect a name on the submitted identity document or if an identity document was not submitted |
| `name_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted individual's name |
| `name_tax_match` | _boolean_ | `true` if the submitted individual's name matches the name listed in a tax form (if it was submitted), `false` otherwise |
| `name_tax_value` | _string_ | The submitted individual's name (from a tax form if it was submitted) |
| `overall_records_match_level` | _string_ | One of the consistency levels (see below) representing overall consistency between submitted identity details and records search results |
| `possibly_deceased` | _boolean_ | `true` if the records search results indicated that the submitted individual is possibly deceased |
| `selfie_liveness_probability_level` | _string_ | One of the consistency levels (see below) representing the probability that the individual in the selfie photo was captured live on camera; `null` if selfie photo and/or Government ID were not collected or if we were unable to detect a face on the selfie photo |
| `tin_multiple_match` | _boolean_ | `true` if the records search matched multiple entities with the submitted US or foreign tax id number, `false` otherwise |
| `tin_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted US or foreign tax id number |

Consistency levels:

- `high` \- records search found a high confidence match (an exact match)
- `medium` \- records search found a medium confidence match (not an exact match, there may be some variation in details, like first name spelling)
- `low` \- records search found a low confidence match (a weak or partial match for some details)
- `none` \- records search found no match

Identity document validity results:

- `valid` \- the identity document is valid and not expired
- `valid_maybe_expired` \- the identity document is valid, but we were unable to verify expiration date
- `expired` \- the identity document is expired
- `unreadable` \- the identity document is unreadable

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-10 "Direct link to Example")

```json
{

"address_id_match": true,

"address_id_value": "123 Fake St, New York, NY, 10011, US",

"address_records_match_level": "high",

"address_submitter_match": true,

"birth_date_id_match": true,

"birth_date_id_value": "1969-12-31",

"birth_date_records_match_level": "high",

"id_validity": "valid",

"id_matching_sides": true,

"id_selfie_similarity_level": null,

"name_id_match": true,

"name_id_value": "Jonathan O'Neill",

"name_records_match_level": "medium",

"name_tax_match": true,

"name_tax_value": "Jonathan O'Neill",

"overall_records_match_level": "high",

"possibly_deceased": false,

"selfie_liveness_probability_level": null,

"tin_multiple_match": false,

"tin_records_match_level": "high"

}
```

### Individual Identity Document Consistency Details [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-identity-document-consistency-details "Direct link to Individual Identity Document Consistency Details")

An object representing the consistency detail results for an individual's identity document.

Identity document validity results:

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-11 "Direct link to Example")

```json
{

"address_id_match": true,

"address_id_value": "123 Fake St, New York, NY, 10011, US",

"birth_date_id_match": true,

"birth_date_id_value": "1969-12-31",

"id_country": "US",

"id_expiration": "2029-12-31",

"id_number": "111222333",

"id_selfie_similarity_level": null,

"id_side": "front",

"id_validity": "valid",

"name_id_match": true,

"name_id_value": "Jonathan O'Neill",

"selfie_liveness_probability_level": null

}
```

### Individual Risk Monitor Match [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#individual-risk-monitor-match "Direct link to Individual Risk Monitor Match")

Information about a potential match between an individual and a sanctioned (or otherwise risky) entity.

| Name | Type | Description |
| --- | --- | --- |
| `adverse_media` | _boolean_ | `true` if the matched individual appears in searched media sources linking them to serious crime (e.g. fraud, money laundering, terrorism, etc.) |
| `birth_date` | _string_ | [Date](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps) representing the matched individual's date of birth |
| `currently_sanctioned` | _boolean_ | `true` if the matched individual appears in any monitored sanctions datasets |
| `deceased` | _boolean_ | `true` if the matched individual is deceased |
| `disqualified_director` | _boolean_ | `true` if the matched individual appears in any searched disqualified director datasets |
| `financial_regulator` | _boolean_ | `true` if the matched individual appears in any searched financial regulator datasets |
| `insolvent` | _boolean_ | `true` if the matched individual appears in any insolvency datasets |
| `first_name` | _boolean_ | The first or given name of the matched individual |
| `middle_name` | _string_ | The last or family name of the matched individual |
| `last_name` | _string_ | The last or family name of the matched individual |
| `law_enforcement` | _boolean_ | `true` if the matched individual appears in any law enforcement datasets |
| `nationalities` | _string\[\]_ | An array of two-letter [ISO Alpha-2 Country Code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes indicating the matched individual's nationality or nationalities |
| `pep` | _boolean_ | `true` if the matched individual is considered a [Politically Exposed Person](https://en.wikipedia.org/wiki/Politically_exposed_person) |
| `previously_sanctioned` | _boolean_ | `true` if the matched individual was sanctioned in the past |
| `score` | _number_ | Entity match score. Higher numbers indicate higher confidence in a positive match. Min: `1`, Max: `100` |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-12 "Direct link to Example")

```json
{

"adverse_media": true,

"birth_date": "1958-04-08",

"currently_sanctioned": true,

"deceased": false,

"disqualified_director": false,

"financial_regulator": false,

"first_name": "Alyona",

"insolvent": false,

"last_name": "Semenov",

"law_enforcement": true,

"middle_name": null,

"nationalities": ["RU"],

"pep": false,

"previously_sanctioned": false,

"score": 73

}
```

## Business Data Structures [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#business-data-structures "Direct link to Business Data Structures")

### Business Profile [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#business-profile "Direct link to Business Profile")

The profile details for a given business.

| Name | Type | Description |
| --- | --- | --- |
| `name` | _string_ | Name of business |
| `business_type` | _string_ | One of the business types below |
| `primary_contact` | _object_ | An [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) representing the primary contact for the business (may be `null` based on permissions) |

Business types:

- `Public Charity` \- A public charity as defined in Section 501(c)(3) of the Internal Revenue Code
- `Private Foundation` \- A private foundation as defined in Section 501(c)(3) of the Internal Revenue Code
- `S Corporation` \- An S-Corp as defined in Subchapter S of Chapter 1 of the Internal Revenue Code
- `C Corporation` \- A C-Corp as defined in the Internal Revenue Code
- `Irrevocable Trust` \- Any irrevocable business or personal trust described in Section 501(a) of the Securities Act of 1933, as amended
- `Revocable Trust` \- Any revocable business or personal trust described in Section 501(a) of the Securities Act of 1933, as amended
- `Other Trust Classification` \- Any other business or personal trust described in Section 501(a) of the Securities Act of 1933, as amended
- `Limited Liability Company` \- A partnership organized as a limited liability company under the laws of its state of formation (includes single-member LLCs and most self-directed IRAs or 401(k) plans)
- `Limited Partnership` \- A partnership organized as a limited partnership under the laws of its state of formation
- `Family Office` \- A "family office" as defined in Rule 202(a)(11)(G)–1 under the Investment Advisers Act of 1940
- `Foreign Corporation` \- A corporation formed under the laws of a nation other than the United States
- `Other Company Classification` \- Any other type of company as defined in the Internal Revenue Code
- `Partnership` \- A partnership organized under the laws of its state of formation
- `Nominee` \- An entity given limited authority to act on behalf of the entity during its formation
- `Eligible Introducer` \- A regulated entity that can perform KYC/CDD on behalf of another entity
- `Fund of Funds` \- An investment vehicle that pools capital from multiple investors to invest in other underlying funds
- `US Government Entity` \- An entity that is part of the United States federal, state, or local government
- `Non-US Commercial Government Entity` \- Any entity located outside the United States that is owned by a foreign government
- `Regulated Entity` \- An entity subject to oversight and rules from a regulatory authority
- `Non-Exempt Regulated Entity` \- An entity that falls under the purview of specific government regulations and does not meet the criteria for exemption from those requirements
- `US Listed Company` \- A company that is publicly traded on a stock exchange in the United States
- `Non-US Listed Company` \- A company that is publicly traded on a stock exchange outside the United States
- `Introduced Investor` \- An entity that has been referred to an investment opportunity by another party

note

Note that the name used here is the current "common" name the business has set in their profile settings, which may not be the same as the business's legal names used in accreditation or identity flows (the legal names in a [Business Accreditation](https://developer.parallelmarkets.com/docs/server/data-structures/#cm-business-accreditation) or [Business Identity Details](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details) response may be different).

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-13 "Direct link to Example")

```json
{

"name": "CompuGlobalHyperMegaNet, Inc.",

"business_type": "Limited Liability Company",

"primary_contact": {

"email": "test@example.com",

"first_name": "Wyman",

"last_name": "Manderly"

}

}
```

### Business Accreditation [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#cm-business-accreditation "Direct link to Business Accreditation")

A representation of an accreditation application by a business.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | Unique identifier for the accreditation |
| `status` | _string_ | One of the statuses listed below |
| `assertion_type` | _string_ | One of the types listed below |
| `created_at` ( **Deprecated**) | _string_ | _Timestamp of when the accreditation application was submitted for the business by a user. Note that `created_at` will be `null` if the user began but never finished their application._ |
| `submitted_at` | _string_ | Timestamp of when the accreditation application was submitted for the business by a user. Note that `submitted_at` will be `null` if the user began but never finished their application. |
| `started_at` | _string_ | Timestamp of when the accreditation application was started for the business by a user. |
| `certified_at` | _string_ | Timestamp of when the accreditation application was certified and accreditation certification letter was issued |
| `expires_at` | _string_ | Timestamp of when the accreditation certification letter expires |
| `rejected_at` | _string_ | Timestamp of when the accreditation application was rejected |
| `cancled_at` | _string_ | Timestamp of when the accreditation application was canceled |
| `name` | _string_ | The name of the company |
| `documents` | _object\[\]_ | A list of Accreditation Document [Record Files](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file) |
| `rejection_reason` | _string_ | One of the reasons listed below (if the accreditation is rejected) |
| `change_ids` | _string_ | Identifiers for the specific [change](https://developer.parallelmarkets.com/docs/server/case-management-api/changes/list) entries associated with the accreditation. |
| `reviewer_note` | _object_ | An [Accreditation Reviewer Note](https://developer.parallelmarkets.com/docs/server/data-structures/#accreditation-reviewer-note) regarding the accreditation. |

Accreditation statuses:

Assertion types:

Accreditation application rejection reasons:

- `expired-document` \- One or more documents have expired
- `mismatched-name` \- Name in document doesn't match applicant name
- `total-worth-invalid` \- Total worth doesn't meet necessary threshold
- `wrong-document-type` \- Wrong document type submitted
- `evaluator-rejection` \- Entity's CPA/Lawyer/Investment Advisor declined to accredit
- `evaluator-letter-invalid` \- Letter wasn't dated within 90 days, didn't mention if docs were reviewed or was not from CPA/BD/Attorney
- `owners-are-not-accredited` \- One or more owners are not accredited
- `mismatched-list-of-owners` \- Business owners list in document doesn't match provided list of owners

note

Note that the name given here may not match the name in the business's current [Business Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details). The name given in the accreditation assertion is the name used at the time of accreditation, and the accreditation is only valid for the business named. The name returned in the business's current [Business Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details) may have changed since the time of the accreditation.

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-14 "Direct link to Example")

```json
{

"assertion_type": "income",

"change_ids": ["UG9kVXNlckRhdGFFbnRyeTo5NTA="],

"created_at": "2023-09-01T12:00:00Z",

"submitted_at": "2023-09-01T12:00:00Z",

"started_at": "2023-09-01T16:00:00Z",

"certified_at": "2023-09-01T16:00:00Z",

"expires_at": "2023-11-01T16:00:00Z",

"rejected_at": null,

"canceled_at": null,

"id": "VXNlckFjY3JlZGl0YXRpb246MQ==",

"status": "current",

"name": "Compu-Global-Hyper-Mega-Net, Inc.",

"reviewer_note": {

"text": "Waiting for additional documentation from subject.",

"created_at": "2023-09-01T16:00:00Z"

}

}
```

### Business Consistency Summary [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#business-consistency-summary "Direct link to Business Consistency Summary")

An object representing the consistency summary results for a business.

| Name | Type | Description |
| --- | --- | --- |
| `address_records_match_level` | _string_ | One of the consistency levels (see below) for the principal [location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) submitted by the business |
| `address_submitter_match` | _boolean_ | `true` if the submitter's location (detected from their IP address) is consistent with the submitted business principal [location](https://developer.parallelmarkets.com/docs/server/data-structures/#location) or incorporation country, `false` otherwise |
| `name_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted business name |
| `name_tax_match` | _boolean_ | `true` if the submitted business name matches business name in a tax form (if it was submitted), `false` otherwise |
| `name_tax_value` | _string_ | The business name from a tax form if it was submitted |
| `overall_records_match_level` | _string_ | One of the consistency levels (see below) representing overall consistency between identity details and records search |
| `tin_multiple_match` | _boolean_ | `true` if records search matched multiple entities with the submitted US or foreign tax id number, `false` otherwise |
| `tin_records_match_level` | _string_ | One of the consistency levels (see below) for the submitted US or foreign tax id number |

Consistency levels:

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-15 "Direct link to Example")

```json
{

"address_records_match_level": "high",

"address_submitter_match": true,

"name_records_match_level": "medium",

"name_tax_match": true,

"name_tax_value": "Hic Sunt Leones LLC",

"overall_records_match_level": "high",

"tin_multiple_match": false,

"tin_records_match_level": "high"

}
```

### Business Risk Monitor Match [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#business-risk-monitor-match "Direct link to Business Risk Monitor Match")

Information about a potential match between a business and a sanctioned (or otherwise risky) entity.

| Name | Type | Description |
| --- | --- | --- |
| `adverse_media` | _boolean_ | `true` if the matched entity appears in searched media sources linking it to serious crime (e.g. fraud, money laundering, terrorism, etc.) |
| `currently_sanctioned` | _boolean_ | `true` if the matched entity appears in any monitored sanctions datasets |
| `disqualified_director` | _boolean_ | `true` if the matched entity appears in any searched disqualified directors datasets |
| `financial_regulator` | _boolean_ | `true` if the matched entity appears in any searched financial regulator datasets |
| `insolvent` | _boolean_ | `true` if the matched entity appears in any insolvency datasets |
| `law_enforcement` | _boolean_ | `true` if the matched entity appears in any law enforcement datasets |
| `name` | _string_ | The name of the matched entity (likely the same or similar to the business name) |
| `pep` | _boolean_ | `true` if the matched entity is considered a [Politically Exposed Person](https://en.wikipedia.org/wiki/Politically_exposed_person) |
| `previously_sanctioned` | _boolean_ | `true` if the matched entity was sanctioned in the past |
| `score` | _number_ | Entity match score. Higher numbers indicate higher confidence in a positive match. Min: `1`, Max: `100` |
| `website` | _string_ | The matched entity's website |

#### Example [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#example-16 "Direct link to Example")

```json
{

"adverse_media": true,

"currently_sanctioned": true,

"disqualified_director": true,

"financial_regulator": true,

"insolvent": true,

"law_enforcement": true,

"name": "Hic Sunt Leones LLC",

"pep": true,

"previously_sanctioned": true,

"score": 97,

"website": "http://hic.sunt.leon.example.com"

}
```

### Control Person [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#control-person "Direct link to Control Person")

A reference to a control person (an individual) containing information necessary to fetch additional details about the individual.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | (Optional) Unique identifier for the controlling individual; If absent, the individual has not submitted or consented to share identity details. |
| `type` | _string_ | `individual` |
| `title` | _string_ | The title this individual holds at the [Business](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details) |
| `profile` | _object_ | An [Individual](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) profile |

#### Examples [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#examples "Direct link to Examples")

A full reference for an individual that has submitted and consented to share identity details will contain an `id` field.

```json
{

"id": "VXNlcjoxMDMyOQ==",

"title": "Headmaster",

"type": "individual",

"profile": {

"email": "apwbd@hogwarts.co.uk",

"first_name": "Albus",

"last_name": "Dumbledore"

}

}
```

A partial reference for an individual that has not consented to share identity details:

```json
{

"title": "Potions Master",

"type": "individual",

"profile": {

"first_name": "Severus",

"last_name": "Snape"

}

}
```

### Beneficial Owner [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#beneficial-owner "Direct link to Beneficial Owner")

A reference to a beneficial owner (an individual or a business) containing information necessary to fetch additional details about the owner individual or business.

| Name | Type | Description |
| --- | --- | --- |
| `id` | _string_ | (Optional) Unique identifier for the beneficial owner entity; If absent, the entity has not submitted or consented to share identity details. |
| `type` | _string_ | `individual` or `business` |
| `ownership_percent` | _number_ | The fractional amount of direct ownership this entity has of the business business (float number > 0.0 and ≤ 1.0) |
| `profile` | _object_ | A [Business](https://developer.parallelmarkets.com/docs/server/data-structures/#business-profile) or [Individual](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile) profile |

#### Examples [​](https://developer.parallelmarkets.com/docs/server/data-structures/\#examples-1 "Direct link to Examples")

A full reference for a business that has submitted and consented to share identity details will contain an `id` field.

```json
{

"id": "QnVzaW5lc3M6MjEzOQ==",

"type": "business",

"ownership_percent": 0.5,

"profile": {

"business_type": "partnership-llc",

"name": "Quicksilver Inc",

"primary_contact": {

"email": "r@sun.cc",

"first_name": "Regulus",

"last_name": "Sun"

}

}

}
```

A partial reference for an individual that has not consented to share identity details:

```json
{

"type": "individual",

"ownership_percent": 0.25,

"profile": {

"email": "nero@aug.us",

"first_name": "Nero",

"last_name": "Augustus"

}

}
```

- [General](https://developer.parallelmarkets.com/docs/server/data-structures/#general)
  - [Location](https://developer.parallelmarkets.com/docs/server/data-structures/#location)
  - [User Session](https://developer.parallelmarkets.com/docs/server/data-structures/#user-session)
  - [Dates and Timestamps](https://developer.parallelmarkets.com/docs/server/data-structures/#dates-and-timestamps)
- [Case Management](https://developer.parallelmarkets.com/docs/server/data-structures/#case-management)
  - [Record](https://developer.parallelmarkets.com/docs/server/data-structures/#record)
  - [Record Comment](https://developer.parallelmarkets.com/docs/server/data-structures/#record-comment)
  - [Record Status](https://developer.parallelmarkets.com/docs/server/data-structures/#record-status)
  - [Risk Match](https://developer.parallelmarkets.com/docs/server/data-structures/#risk-match)
  - [Risk Match Review Details](https://developer.parallelmarkets.com/docs/server/data-structures/#risk-match-review-details)
  - [Risk Match Review Article](https://developer.parallelmarkets.com/docs/server/data-structures/#risk-match-review-article)
  - [Individual Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-record-details)
  - [Business Record Details](https://developer.parallelmarkets.com/docs/server/data-structures/#business-record-details)
  - [Record File](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file)
  - [Record File Type](https://developer.parallelmarkets.com/docs/server/data-structures/#record-file-type)
  - [Secondary Tax ID](https://developer.parallelmarkets.com/docs/server/data-structures/#secondary-tax-id)
  - [Record Trait](https://developer.parallelmarkets.com/docs/server/data-structures/#record-trait)
  - [Accreditation Reviewer Note](https://developer.parallelmarkets.com/docs/server/data-structures/#accreditation-reviewer-note)
- [Individual Data Structures](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-data-structures)
  - [Individual Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-profile)
  - [Individual Accreditation](https://developer.parallelmarkets.com/docs/server/data-structures/#cm-individual-accreditation)
  - [Individual Consistency Summary](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-consistency-summary)
  - [Individual Identity Document Consistency Details](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-identity-document-consistency-details)
  - [Individual Risk Monitor Match](https://developer.parallelmarkets.com/docs/server/data-structures/#individual-risk-monitor-match)
- [Business Data Structures](https://developer.parallelmarkets.com/docs/server/data-structures/#business-data-structures)
  - [Business Profile](https://developer.parallelmarkets.com/docs/server/data-structures/#business-profile)
  - [Business Accreditation](https://developer.parallelmarkets.com/docs/server/data-structures/#cm-business-accreditation)
  - [Business Consistency Summary](https://developer.parallelmarkets.com/docs/server/data-structures/#business-consistency-summary)
  - [Business Risk Monitor Match](https://developer.parallelmarkets.com/docs/server/data-structures/#business-risk-monitor-match)
  - [Control Person](https://developer.parallelmarkets.com/docs/server/data-structures/#control-person)
  - [Beneficial Owner](https://developer.parallelmarkets.com/docs/server/data-structures/#beneficial-owner)