> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://documentation.sayari.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://documentation.sayari.com/_mcp/server.

Our data is delivered in two sets of files: entities and relationships. Within each file, a row describes one entity or relationship.

We provide schemas in JSON and text formats here to accommodate various development needs.


<Note title="Note">
Any entity or relationship may have multiple attributes of the same type; for example, an entity may have multiple addresses (physical, mailing, etc.). Accordingly, all attributes are included as arrays.
</Note>


### Entities

Like an entity profile in the Sayari suite of products, a row in an entity file describes a single entity, including its [attributes](https://sayari-analytics-preview-eac13c01-9d7f-40cc-8dae-893c07a5c00e.docs.buildwithfern.com/sayari-library/ontology/attributes), [risk factors](https://sayari-analytics-preview-eac13c01-9d7f-40cc-8dae-893c07a5c00e.docs.buildwithfern.com/sayari-library/ontology/risk-factors), and summary information.

Summary information includes properties that describe the entity, as outlined below:
|Field|Type|Description|
| :--- | :--- | :--- |
|entity_id|`string`|Unique identifier of the entity|
|type|`string`|The type of [entity](/sayari-library/ontology/entities)|
|label|`string`|The entity name, or defaults to attributes like identifier, weak identifier, or address if no name is available, e.g., a property identified by its address|
|label_en|`string`|The name of the entity in Latin script, selected as the most suitable from available sources.|
|num_documents|`integer`|Number of documents that make reference to the entity|
|sanctioned|`boolean`|Whether or not the entity is [sanctioned](/sayari-library/ontology/risk-factors#sanctioned)|
|pep|`boolean`|Whether or not the entity is considered a [politically exposed person](/sayari-library/ontology/risk-factors#politically-exposed-person-pep)|
|degree|`long`|Number of outgoing relationships|
|closed|`string`|True if a relevant closed status has been parsed for this entity. Always false for data curation.|
|edge_counts|`map`|Counts of incoming, outgoing, and total edges|
|risk_factors|`struct`|Contains the [risks](/sayari-library/ontology/risk-factors) associated with the entity|
|name|array of `struct`|Values of the [name](/sayari-library/ontology/attributes#name) attribute|
|identifier|array of `struct`|Values of the [identifier](/sayari-library/ontology/attributes#identifier) attribute|
|additional_information|array of `struct`|Values of the [additional_information](/sayari-library/ontology/attributes#additional-information) attribute|
|address|array of `struct`|Values of the [address](/sayari-library/ontology/attributes#address) attribute|
|business_purpose|array of `struct`|Values of the [business_purpose](/sayari-library/ontology/attributes#business-purpose) attribute|
|company_type|array of `struct`|Values of the [company_type](/sayari-library/ontology/attributes#company-type) attribute|
|contact|array of `struct`|Values of the [contact](/sayari-library/ontology/attributes#contact) attribute|
|country|array of `struct`|Values of the [country](/sayari-library/ontology/attributes#country) attribute|
|date_of_birth|array of `struct`|Values of the [date_of_birth](/sayari-library/ontology/attributes#date-of-birth) attribute|
|financials|array of `struct`|Values of the [financials](/sayari-library/ontology/attributes#financials) attribute|
|gender|array of `struct`|Values of the [gender](/sayari-library/ontology/attributes#gender) attribute|
|measurement|array of `struct`|Values of the [measurement](/sayari-library/ontology/attributes#measurement) attribute|
|monetary_value|array of `struct`|Values of the [monetary_value](/sayari-library/ontology/attributes#monetary-value) attribute|
|risk_intelligence|array of `struct`|Values of the [risk_intelligence](/sayari-library/ontology/attributes#risk-intelligence) attribute|
|shares|array of `struct`|Values of the [shares](/sayari-library/ontology/attributes#shares) attribute|
|status|array of `struct`|Values of the [status](/sayari-library/ontology/attributes#status) attribute|
|sources|array of `string`|An array of sources associated with the entity|


This schema information is also in available more detail in both [JSON](https://fern-doc-assets.s3.amazonaws.com/entities.schema.json) and [Text](https://fern-doc-assets.s3.amazonaws.com/entities.schema.txt) format

### Relationships

A row in a relationship file describes a single relationship, including its attributes and summary information. Relationships connect two entities (i.e., vertices), which are specified by their `entity_ids`s.
|Field|Type|Description|
| :--- | :--- | :--- |
|src|`string`|The `source` / `from` of the relationship (specified as an `entity_id`)|
|dst|`string`|The `destination` / `to` of the relationship (specified as an `entity_id`)|
|type|`string`|The relationship [type](/sayari-library/ontology/relationships)|
|date|`string`|The as-of date of a relationship (YYYY-MM-DD)|
|from_date|`string`|The start date of a relationship (YYYY-MM-DD)|
|to_date|`string`|The end date of a relationship (YYYY-MM-DD)|
|former|`boolean`||
|additional_information|array of `struct`|Values of the [additional_information](/sayari-library/ontology/attributes#additional-information) attribute|
|position|array of `struct`|Values of the [position](/sayari-library/ontology/attributes#position) attribute|
|shares|array of `struct`|Values of the [shares](/sayari-library/ontology/attributes#shares) attribute|
|business_purpose|array of `struct`|Values of the [business_purpose](/sayari-library/ontology/attributes#business-purpose) attribute|
|match_keys|array of `struct`|Specific keys used for matching operations, populated only when type equals `possibly_same_as`, indicating potential identity matches between entities.|
|as_of|`string`||
|most_recent_crawl|`string`||


This schema information is also in available more detail in both [JSON](https://fern-doc-assets.s3.amazonaws.com/relationships.schema.json) and [Text](https://fern-doc-assets.s3.amazonaws.com/relationships.schema.txt) format