# Entity Schema

{% hint style="success" %}
*New GraphQL definitions coming soon! Fields subject to change without notice during beta.*
{% endhint %}

{% hint style="info" %}
 A Fide Entity will always represent a person, project, or legal organization.
{% endhint %}

> **Standard `{"key" : "value"}` JSON schema for all Fide Entities from an** [**Entity Endpoint**](https://docs.fide.id/legacy-endpoints#entity)**.**

<table data-full-width="true"><thead><tr><th width="179">key</th><th width="216.33333333333331">type</th><th width="236">description</th></tr></thead><tbody><tr><td><strong>fide_id</strong></td><td><code>string</code></td><td>Fide's unique identifier for the Entity</td></tr><tr><td><strong>names</strong></td><td><code>dictionary</code></td><td><a href="#names"><code>Names</code></a></td></tr><tr><td><strong>images</strong></td><td><code>dictionary</code></td><td><a href="#images"><code>Images</code></a></td></tr><tr><td><strong>descriptions</strong></td><td><code>dictionary</code></td><td><a href="#descriptions"><code>Descriptions</code></a></td></tr><tr><td><strong>times</strong></td><td><code>dictionary</code></td><td><a href="#times"><code>Times</code></a></td></tr><tr><td><strong>types</strong></td><td><code>string[]</code></td><td><a href="#type"><code>Type</code></a></td></tr><tr><td><strong>tags</strong></td><td><code>string[]</code></td><td><a href="#tags"><code>Tags</code></a></td></tr><tr><td><strong>links</strong></td><td><code>dictionary</code></td><td><a href="#sources"><code>Links</code></a> <br><br>(twitter, discord, telegram, arkham, blockdata, cookbook, cyberconnect, disco, friendtech, lenster, github, linkedin, messari, moralis, opensea, poap, spotify, zapper, golden, and more)</td></tr><tr><td><strong>statistics</strong></td><td><code>dictionary</code></td><td><a href="#statistics"><code>Statistics</code></a></td></tr><tr><td><strong>team</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> from entities</td></tr><tr><td><strong>experiences</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> to entities</td></tr><tr><td><strong>subsidiaries</strong></td><td><code>dictionary</code></td><td><p><a href="#contributions"><code>Contributions</code></a> from entities</p><p>(ex: "child" entities this "parent" entity receives contributions <strong>from</strong>)</p></td></tr><tr><td><strong>parent_companies</strong></td><td><code>dictionary</code></td><td><p><a href="#contributions"><code>Contributions</code></a> to entities</p><p>(ex: the "parent" entities this "child" entity contributes <strong>to</strong>)</p></td></tr><tr><td><strong>sources_created</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> to sources</td></tr><tr><td><strong>investors</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> from entities</td></tr><tr><td><strong>investments</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> to entities</td></tr><tr><td><strong>locations</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> to source<br>(ex: "location" sources this entity contributes <strong>to</strong> such as <code>organization</code> headquarters)</td></tr><tr><td><strong>ecosystems</strong></td><td><code>dictionary</code></td><td><a href="#contributions"><code>Contributions</code></a> (to entities)</td></tr><tr><td><strong>fide_time_created</strong></td><td><code>unix timestamp</code></td><td>time Fide Source was created</td></tr><tr><td><strong>fide_time_updated</strong></td><td><code>unix timestamp</code></td><td>time Fide Source was updated</td></tr></tbody></table>

## Links

| key              | type         | description       |
| ---------------- | ------------ | ----------------- |
| fide\_source\_id | `string`     |                   |
| source\_name     | `string`     |                   |
| identifiers      | `dictionary` | LINK IDENTIFIERS  |
| statistics       | `dictionary` | LINK STATISTICS   |
| descriptions     | `dictionary` | LINK DESCRIPTIONS |

## LINK IDENTIFIERS

{ bsonType: 'object', properties: { id: { bsonType: 'string' }, slug: { bsonType: 'array', items: { bsonType: 'string' } }, blockchain\_address: { bsonType: 'string' }, blockchain\_hash: { bsonType: 'string' } } }

## LINK STATISTICS

republications\_count: { bsonType: 'int' }, publication\_replies\_count: { bsonType: 'int' }, publication\_quotes\_count: { bsonType: 'int' }, collects\_count: { bsonType: 'int' }, followers\_count: { bsonType: 'int' }, following\_count: { bsonType: 'int' }, subscribers\_count: { bsonType: 'int' }, subscriptions\_count: { bsonType: 'int' }, views\_count: { bsonType: 'int' }, likes\_count: { bsonType: 'int' }, deployments\_count: { bsonType: 'int' }, saves\_count: { bsonType: 'int' }, publications\_count: { bsonType: 'int' }

## LINK DESCRIPTIONS

short

location\_name

## Contributions

| key                 | type           | description                                                           |
| ------------------- | -------------- | --------------------------------------------------------------------- |
| contributions       | `dictionary[]` | [`Contribution Schema`](https://docs.fide.id/api/contribution-schema) |
| item\_count         | `number`       | the total number of items                                             |
| per\_page           | `number`       | the total number of items per page                                    |
| current\_page       | `number`       | the current page number                                               |
| page\_count         | `number`       | the total number of pages                                             |
| has\_previous\_page | `boolean`      | if has previous page                                                  |
| has\_next\_page     | `boolean`      | if has next page                                                      |

## Names

| key       | type       | description                                     |
| --------- | ---------- | ----------------------------------------------- |
| all       | `string[]` | names in order of prominence                    |
| first     | `string`   | legal first name                                |
| middle    | `string[]` | legal middle name(s)                            |
| last      | `string`   | legal first name                                |
| symbol    | `string`   | official token or ticker symbol                 |
| pseudonym | `string`   | commonly used digital name                      |
| prefixes  | `string[]` | a word, letter, or number placed before a name. |
| suffixes  | `string[]` | a word, letter, or number placed after a name.  |

## Images

<table><thead><tr><th width="242.33333333333331">key</th><th width="147">type</th><th>description</th></tr></thead><tbody><tr><td>primary</td><td><code>string</code></td><td>primary image url</td></tr><tr><td>secondary</td><td><code>string</code></td><td>secondary image url</td></tr><tr><td>tertiary</td><td><code>string</code></td><td>tertiary image url</td></tr><tr><td>banner</td><td><code>string</code></td><td>banner image url</td></tr></tbody></table>

## Descriptions

<table><thead><tr><th width="243.33333333333331">key</th><th width="149">type</th><th>description</th></tr></thead><tbody><tr><td>short</td><td><code>string</code></td><td>>200 characters</td></tr><tr><td>medium</td><td><code>string</code></td><td>200-500 characters</td></tr><tr><td>long</td><td><code>string</code></td><td>&#x3C;500 characters</td></tr><tr><td>technical</td><td><code>string</code></td><td>technical description</td></tr><tr><td>token_usage</td><td><code>string</code></td><td>token_usage description</td></tr><tr><td>regulation</td><td><code>string</code></td><td>regulation description</td></tr><tr><td>governance_off_chain</td><td><code>string</code></td><td>governance_off_chain description</td></tr><tr><td>governance_on_chain</td><td><code>string</code></td><td>governance_on_chain description</td></tr></tbody></table>

## Times

<table><thead><tr><th width="179.33333333333331">key</th><th width="213">type</th><th>description</th></tr></thead><tbody><tr><td>start</td><td><code>unix timestamp</code></td><td>time <code>project</code> or <code>organization</code> first active</td></tr><tr><td>start_range</td><td><code>number</code></td><td>confidence range equally distributed before and after <code>start</code> measured in milliseconds</td></tr><tr><td>end</td><td><code>unix timestamp</code></td><td>time <code>project</code> or <code>organization</code> last inactive</td></tr><tr><td>end_range</td><td><code>number</code></td><td>confidence range equally distributed before and after <code>end</code> measured in milliseconds</td></tr><tr><td>first_blockchain_transaction</td><td><code>unix timestamp</code></td><td>time of first transaction on any immutable blockchain</td></tr></tbody></table>

## Statistics

<table><thead><tr><th width="247">key</th><th width="163.33333333333331">type</th><th>description</th></tr></thead><tbody><tr><td>followers_count</td><td><code>number</code></td><td>latest count of "followers" or similar</td></tr><tr><td>following_count</td><td><code>number</code></td><td>latest count of "following" or similar</td></tr><tr><td>subscribers_count</td><td><code>number</code></td><td>latest count of "subscribers" or similar</td></tr><tr><td>subscriptions_count</td><td><code>number</code></td><td>latest count of "subscriptions" or similar</td></tr><tr><td>views_count</td><td><code>number</code></td><td>latest count of "views", "visits", "impressions" or similar</td></tr><tr><td>likes_count</td><td><code>number</code></td><td>latest count of "likes", "favorites", "stars", "hearts" or similar</td></tr><tr><td>deployments_count</td><td><code>number</code></td><td>latest count of "deployments", "times published" or similar</td></tr><tr><td>saves_count</td><td><code>number</code></td><td>latest count of "saves" or similar</td></tr><tr><td>publications_count</td><td></td><td></td></tr><tr><td>publication_quotes_count</td><td></td><td></td></tr><tr><td>publication_replies_count</td><td></td><td></td></tr><tr><td>republications_count</td><td></td><td></td></tr></tbody></table>

## Type

<table><thead><tr><th width="250.33333333333331">value</th><th>description</th></tr></thead><tbody><tr><td>person</td><td></td></tr><tr><td>project</td><td></td></tr><tr><td>organization</td><td></td></tr></tbody></table>

## Tags

<table><thead><tr><th width="253">value</th><th>description</th></tr></thead><tbody><tr><td>entrepreneur</td><td>has been a start-up founder</td></tr><tr><td>tool</td><td></td></tr><tr><td>web3_powered</td><td></td></tr><tr><td>event_focused</td><td></td></tr><tr><td>web3_focused</td><td></td></tr><tr><td>dao_focused</td><td></td></tr><tr><td>tool</td><td></td></tr><tr><td>media_outlet</td><td></td></tr><tr><td>dao</td><td></td></tr><tr><td>web3_token</td><td></td></tr><tr><td>blockchain</td><td></td></tr><tr><td>layer_1</td><td></td></tr><tr><td>layer_2</td><td></td></tr><tr><td>hackathon_project</td><td></td></tr><tr><td>hackathon</td><td></td></tr><tr><td>erc_20</td><td></td></tr></tbody></table>