Guides

LegalEntity

Attributes available to legal entities in the Knowledge Graph.

Suggest Edits

The LegalEntity entity type includes companies and organizations with legal status and identifiers.

For convenience, a complete ontology source in JSON format is also available here.

🙋

New to the Diffbot Knowledge Graph? Start here.

LegalEntity Fields

LegalEntity Field Details

Note that certain longer field examples may be truncated for readability.

allDescriptions

All descriptions found for this entity. For the best description, refer to the field 'description'.

  • Type: String
  • Example:
{
	"allDescriptions": ""
}

allNames

All names used, including nicknames, full names and transliterations to other languages.

  • Type: String
  • Example:
{
	"allNames": [
		"GENERAL MOTORS FINANCIAL COMPANY, INC."
	]
}

allOriginHashes

For Diffbot's internal use only.

  • Type: String
  • Example:
{
	"allOriginHashes": [
		"lmpTh5IoNm-jN_lU3AhqkA"
	]
}

allUriDetails

Additional information about each URI in 'allUris', which lists the URIs associated with this entity.

  • Type: UriDetails
  • Example:
{
	"allUriDetails": [
		{
			"domainMonthlyTrafficGrowth": "",
			"domainMonthlyTraffic": 0,
			"redirectsTo": "",
			"nbFollowing": 0,
			"uriType": "",
			"verified": false,
			"nbLinkedAccounts": 0,
			"nbFollowers": 0,
			"httpCodeTimestamp": 0,
			"httpCode": "",
			"uri": ""
		}
	]
}

allUris

All URIs associated with an entity. A URI (uniform resource identifier) is a page on the web that describes an entity (e.g., an company's homepage or a person's social network profile).

  • Type: URL
  • Example:
{
	"allUris": [
		"gleif.org/5493008B6JBRUJ90QL97"
	]
}

bicCodes

BIC number or SWIFT code — is a standard format for Business Identifier Codes (BIC). It's used to identify banks and financial institutions.

  • Type: String
  • Example:
{
	"bicCodes": ""
}

category

Indicates (where applicable) the category of Entity identified by this LEI Data Record, as a more specific category within the broad definition given in ISO 17442. These categories are based on use cases specified in ROC policies, found at the ROC website.

  • Type: EntityCategory
  • Example:
{
	"category": {}
}

crawlTimestamp

The default crawlTimestamp is the most recent date of all of the crawlTimestamps of the origins used to compute the Entity, returned as a UNIX time.

  • Type: Integer
  • Example:
{
	"crawlTimestamp": 1728370800
}

description

A few sentences describing an entity

  • Type: String
  • Example:
{
	"description": ""
}

descriptors

A list of free-form keywords describing this entity

  • Type: String
  • Example:
{
	"descriptors": ""
}

diffbotUri

diffbotUri is the URI an entity's (URI), which is defined by appending the Diffbot ID to the URL https://diffbot.com/entity/. For example, Diffbot's entityID is CWSwJ_SWQPfqO3HQsxY4lGg and its DiffbotUri is https://diffbot.com/entity/CWSwJ_SWQPfqO3HQsxY4lGg

  • Type: URL
  • Example:
{
	"diffbotUri": "http://diffbot.com/entity/ElmpTh5IoNm-jN_lU3AhqkA"
}

expirationReason

The reason that a Legal Entity ceased to operate. This element SHALL be present if EntityExpirationDate is present, and omitted otherwise.

  • Type: ExpirationReason
  • Example:
{
	"expirationReason": {}
}

from

The date on which the legal entity was first established as defined in ISO 17442.

  • Type: DDate
  • Example:
{
	"from": {
		"str": "d1988-05-18",
		"precision": 3,
		"timestamp": 579916800000
	}
}

gleifId

The Legal Entity Identifier (LEI) is a 20-character, alpha-numeric code based on the ISO 17442 standard developed by the International Organization for Standardization (ISO)

  • Type: String
  • Example:
{
	"gleifId": "5493008B6JBRUJ90QL97"
}

id

An alphanumeric string like CWSwJ_SWQPfqO3HQsxY4lGg that uniquely identifies an entity.

  • Type: String
  • Example:
{
	"id": "ElmpTh5IoNm-jN_lU3AhqkA"
}

image

The main image used to represent the entity.

  • Type: String
  • Example:
{
	"image": ""
}

images

The visual representation of an entity usually in the form of a png, jpeg, gif, or svg file.

  • Type: ImageField
  • Example:
{
	"images": [
		{
			"classifications": "",
			"fingerprint": "",
			"title": "",
			"isCached": false,
			"url": ""
		}
	]
}

importance

A number between 0 and 100 indicating how important or popular an entity is.

  • Type: Float
  • Example:
{
	"importance": 87.46067810058594
}

isCurrent

The status of Legal Entity.

  • Type: Boolean
  • Example:
{
	"isCurrent": false
}

isinCodes

International Securities Identification Number (ISIN) is a 12-digit alphanumeric code that uniquely identifies a specific security.

  • Type: String
  • Example:
{
	"isinCodes": ""
}

legalFormCode

The legal form of the Entity, taken from the ISO Entity Legal Form (ELF) code list maintained by GLEIF. The XML schema validates the format of EntityLegalFormCode codes but not the specific codes conforming to the ISO standard it requires.

  • Type: String
  • Example:
{
	"legalFormCode": "C5K7"
}

legalFormName

The legal form of the Entity, taken from the ISO Entity Legal Form (ELF) code list maintained by GLEIF. The XML schema validates the format of EntityLegalFormCode codes but not the specific codes conforming to the ISO standard it requires.

  • Type: String
  • Example:
{
	"legalFormName": "For-Profit Corporation"
}

legalJurisdiction

The jurisdiction of legal formation and registration of the Entity (and on which the Legalform data element is also dependent).

  • Type: LinkedEntity
  • Example:
{
	"legalJurisdiction": {
		"summary": "State of the United States of America",
		"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FgvFv%3Er%5DA%5Bw%7B%3C%3AOh%3De%7B78Wm%3E.o%3BK",
		"types": [
			"Place",
			"AdministrativeArea",
			"Region"
		],
		"name": "Texas",
		"diffbotUri": "http://diffbot.com/entity/EkoIuXpjvM6eoD4DCh1PbPA",
		"targetDiffbotId": "EkoIuXpjvM6eoD4DCh1PbPA",
		"type": "Place"
	}
}

location

The main/headquarters location of the entity.

  • Type: Location
  • Example:
{
	"location": {
		"venue": "Fort Worth Us-Tx Us",
		"country": {
			"summary": "Country primarily located in North America",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FhvGq%3Eh%5D%7Dab%3B%60zBlElnGl6anIdpR%7BW%5EvOdKQBTx.oCJ",
			"types": [
				"Place",
				"AdministrativeArea",
				"Country"
			],
			"name": "United States of America",
			"diffbotUri": "http://diffbot.com/entity/E01d4EK33MmCosgI2KXa4-A",
			"targetDiffbotId": "E01d4EK33MmCosgI2KXa4-A",
			"type": "Place"
		},
		"address": "Fort Worth Us-Tx Us, 801 Cherry St Ste 3600, Fort Worth, Texas",
		"city": {
			"summary": "City and county seat of Tarrant County, Texas, United States",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FgvFw%3Ek%5D%3Eabsi%3DUb7%3F%7B9m.ToJ",
			"types": [
				"Place",
				"AdministrativeArea",
				"City"
			],
			"name": "Fort Worth",
			"diffbotUri": "http://diffbot.com/entity/ENymUw3O6Nly3jv5gFB2NHw",
			"targetDiffbotId": "ENymUw3O6Nly3jv5gFB2NHw",
			"type": "Place"
		},
		"subregion": {
			"summary": "County in Texas, United States",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FdvCu%3EkZ%7DTb%3B%60z5%5BJkpFz60uYs%3F%5D%2CBMwhrJ.Ael",
			"types": [
				"Place",
				"AdministrativeArea",
				"Subregion"
			],
			"name": "Tarrant County",
			"diffbotUri": "http://diffbot.com/entity/EaLbH-55VMOG7ZE6399zB5w",
			"targetDiffbotId": "EaLbH-55VMOG7ZE6399zB5w",
			"type": "Place"
		},
		"latitude": 32.72944259643555,
		"precision": 30.061264038085938,
		"postalCode": "76102",
		"locationType": [
			"Headquarters"
		],
		"street": "801 Cherry St Ste 3600",
		"metroArea": {
			"summary": "Conurbation in Texas, United States",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FevDo%3EiO8Yd%3FYnLsDb%7D%3DeNVzLd%5CV6VXVY4Kb7Ry.f%3DJ",
			"types": [
				"Place",
				"AdministrativeArea"
			],
			"name": "Dallas-Fort Worth metroplex",
			"diffbotUri": "http://diffbot.com/entity/E_vmezEWuP1-Um7y2iDA6xw",
			"targetDiffbotId": "E_vmezEWuP1-Um7y2iDA6xw",
			"type": "Place"
		},
		"region": {
			"summary": "State of the United States of America",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FgvFv%3Er%5DA%5Bw%7B%3C%3AOh%3De%7B78Wm%3E.o%3BK",
			"types": [
				"Place",
				"AdministrativeArea",
				"Region"
			],
			"name": "Texas",
			"diffbotUri": "http://diffbot.com/entity/EkoIuXpjvM6eoD4DCh1PbPA",
			"targetDiffbotId": "EkoIuXpjvM6eoD4DCh1PbPA",
			"type": "Place"
		},
		"longitude": -97.3318099975586
	}
}

locations

The locations of the entity.

  • Type: Location
  • Example:
{
	"locations": [
		{
			"country": {
				"summary": "Country primarily located in North America",
				"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FhvGq%3Eh%5D%7Dab%3B%60zBlElnGl6anIdpR%7BW%5EvOdKQBTx.oCJ",
				"types": [
					"Place",
					"AdministrativeArea",
					"Country"
				],
				"name": "United States of America",
				"diffbotUri": "http://diffbot.com/entity/E01d4EK33MmCosgI2KXa4-A",
				"targetDiffbotId": "E01d4EK33MmCosgI2KXa4-A",
				"type": "Place"
			},
			"address": "C/O Corporation Service Company D/B/A Csc-Lawyers Inco 211 E. 7th Street Suite 620, Austin, Texas",
			"city": {
				"summary": "City in and county seat of Travis County, Texas, United States, that is also the capital of the State of Texas",
				"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FCvrr%3Eh%5D%7Dab%3B%60zBlElnGl6%7E%7BWy4R%2CBMwhrJ.Ael",
				"types": [
					"Place",
					"AdministrativeArea",
					"City"
				],
				"name": "Austin",
				"diffbotUri": "http://diffbot.com/entity/E8y6iIzzkPbKiZdINSDRnYQ",
				"targetDiffbotId": "E8y6iIzzkPbKiZdINSDRnYQ",
				"type": "Place"
			},
			"street": "C/O Corporation Service Company D/B/A Csc-Lawyers Inco 211 E. 7th Street Suite 620",
			"subregion": {
				"summary": "County in Texas, United States",
				"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FFvuQ%3Ey%60%7Dcl%3F-%7EPoFm8-zO-yIf7.%7CS%60",
				"types": [
					"Place",
					"AdministrativeArea",
					"Subregion"
				],
				"name": "Travis County",
				"diffbotUri": "http://diffbot.com/entity/EDGJheiLNONenoXj_lPLWLA",
				"targetDiffbotId": "EDGJheiLNONenoXj_lPLWLA",
				"type": "Place"
			},
			"latitude": 30.22234535217285,
			"precision": 28.124937057495117,
			"postalCode": "78701",
			"locationType": [
				"Legal"
			],
			"region": {
				"summary": "State of the United States of America",
				"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FgvFv%3Er%5DA%5Bw%7B%3C%3AOh%3De%7B78Wm%3E.o%3BK",
				"types": [
					"Place",
					"AdministrativeArea",
					"Region"
				],
				"name": "Texas",
				"diffbotUri": "http://diffbot.com/entity/EkoIuXpjvM6eoD4DCh1PbPA",
				"targetDiffbotId": "EkoIuXpjvM6eoD4DCh1PbPA",
				"type": "Place"
			},
			"longitude": -97.83651733398438
		}
	]
}

micCodes

Market identifier code (MIC) is an international indicator that identifies stock markets and trading exchanges for trading computers.

  • Type: String
  • Example:
{
	"micCodes": ""
}

name

Primary text label for this entity.

  • Type: String
  • Example:
{
	"name": "GENERAL MOTORS FINANCIAL COMPANY, INC."
}

nbIncomingEdges

This is the number of edges in the Knowledge Graph that point to this entity. For example, the nbIncomingEdges field for Google is over 100,000. This number includes the number of people that work at google, the number of investors who invested in google, etc.

  • Type: Integer
  • Example:
{
	"nbIncomingEdges": 503
}

nbOrigins

Total number of origins in the field 'origins'. This field is only available in extended JSON mode.

  • Type: Integer
  • Example:
{
	"nbOrigins": 1
}

nonCanonicalFacts

Enumerates all the non-canonical fields (i.e., those not defined in the ontology) that have a value for this entity. For instance, if 'numberOfChildren' is listed in 'nonCanonicalFacts' then the entity JSON will have the key 'numberOfChildren' with an associated value. This field is only provided when the parameter nonCanonicalFacts=1 is set. See: https://docs.diffbot.com/kgapi

  • Type: String
  • Example:
{
	"nonCanonicalFacts": ""
}

originDetails

Additional information about origins listed in 'origins', including the latest time it was crawled. This field is only available in extended JSON mode.

  • Type: OriginDetail
  • Example:
{
	"originDetails": [
		{
			"crawledAt": {
				"str": "",
				"precision": 0,
				"timestamp": 0
			},
			"origin": ""
		}
	]
}

origins

An origin is a web address where Diffbot found one or more facts about an entity. This field is only available in extended JSON mode.

  • Type: String
  • Example:
{
	"origins": [
		"gleif.org/5493008B6JBRUJ90QL97"
	]
}

parent

The parent company of this subsidiary.

  • Type: LinkedEntity
  • Example:
{
	"parent": [
		{
			"summary": "",
			"image": "",
			"images": [
				{
					"classifications": "",
					"fingerprint": "",
					"title": "",
					"isCached": false,
					"url": ""
				}
			],
			"types": "",
			"diffbotUri": "",
			"name": "",
			"targetDiffbotUri": ""
		}
	]
}

registerName

The name of the register

  • Type: String
  • Example:
{
	"registerName": ""
}

registrationAuthority

The registration authority

  • Type: LinkedEntity
  • Example:
{
	"registrationAuthority": {
		"name": "Corporations Section (Texas Secretary of State)",
		"type": "Organization"
	}
}

relationships

The list of relationships from this legal entity to other legal entities

  • Type: LegalEntityRelationship
  • Example:
{
	"relationships": [
		{
			"relationshipPeriod": "",
			"isCurrent": false,
			"relationshipType": "",
			"relatedEntity": {
				"summary": "",
				"image": "",
				"images": [
					{
						"classifications": "",
						"fingerprint": "",
						"title": "",
						"isCached": false,
						"url": ""
					}
				],
				"types": "",
				"diffbotUri": "",
				"name": "",
				"targetDiffbotUri": ""
			},
			"from": {
				"str": "",
				"precision": 0,
				"timestamp": 0
			}
		}
	]
}

subCategory

Indicates and specifies further (where applicable) the sub-category (sub-sector) of Legal Entity identified by this LEI Record and already categorized by the EntityCategory.

  • Type: EntitySubCategory
  • Example:
{
	"subCategory": {}
}

subsidiaries

Current subsidiaries of this organization.

  • Type: LinkedEntity
  • Example:
{
	"subsidiaries": [
		{
			"types": [
				"LegalEntity"
			],
			"name": "GMF Prime Automobile Trust 2023-PP2",
			"diffbotUri": "http://diffbot.com/entity/E02M9Q4msMXawz8hLc-QVeA",
			"targetDiffbotId": "E02M9Q4msMXawz8hLc-QVeA",
			"type": "LegalEntity"
		},
		{
			"types": [
				"LegalEntity"
			],
			"name": "GMF Prime Automobile Trust 2023-PP2",
			"diffbotUri": "http://diffbot.com/entity/E02M9Q4msMXawz8hLc-QVeA",
			"targetDiffbotId": "E02M9Q4msMXawz8hLc-QVeA",
			"type": "LegalEntity"
		},
		{
			"types": [
				"LegalEntity"
			],
			"name": "GM FINANCIAL AUTOMOBILE LEASING TRUST 2022-1",
			"diffbotUri": "http://diffbot.com/entity/E7-Egb5iSPpqa54ZY0BjFrg",
			"targetDiffbotId": "E7-Egb5iSPpqa54ZY0BjFrg",
			"type": "LegalEntity"
		}
	]
}

successorEntity

The surviving/new Legal Entity which continues/replaces this LEI registration, where applicable.

  • Type: LinkedEntity
  • Example:
{
	"successorEntity": {
		"summary": "",
		"image": "",
		"images": [
			{
				"classifications": "",
				"fingerprint": "",
				"title": "",
				"isCached": false,
				"url": ""
			}
		],
		"types": "",
		"diffbotUri": "",
		"name": "",
		"targetDiffbotUri": ""
	}
}

summary

A short phrase designed to disambiguate entities with the same or similar name

  • Type: String
  • Example:
{
	"summary": ""
}

to

The date the Legal Entity ceased operation or was merged. This element SHALL be present if EntityExpirationReason is present, and omitted otherwise.

  • Type: DDate
  • Example:
{
	"to": {
		"str": "",
		"precision": 0,
		"timestamp": 0
	}
}

type

The top-level type of a Diffbot entity. Examples of type include Person, Organization, Article, Product.

  • Type: Type
  • Example:
{
	"type": "LegalEntity"
}

types

All types of a Diffbot entity, including the value of the field 'type'.

  • Type: String
  • Example:
{
	"types": [
		"LegalEntity"
	]
}

ultimateParent

The ultimate parent company of this subsidiary.

  • Type: LinkedEntity
  • Example:
{
	"ultimateParent": [
		{
			"summary": "",
			"image": "",
			"images": [
				{
					"classifications": "",
					"fingerprint": "",
					"title": "",
					"isCached": false,
					"url": ""
				}
			],
			"types": "",
			"diffbotUri": "",
			"name": "",
			"targetDiffbotUri": ""
		}
	]
}

wikipediaPageviews

The number of views of its Wikipedia page of the last month if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviews": 0
}

wikipediaPageviewsGrowth

The month over month growth of wikipediaPageviews, where we count the increment of the number of page views of the second to last (full) month, compared with that of the last (full) month. if today was Aug 16th, 2022, the last complete month is July. So it refers to the increment from June to July, i.e., ( f(July) - f(June) ) ÷ f(June) x 100%. The f(.) only counts the first 28 days of a month, to avoid fluctuations between 31-days months like Jan and 28(29)-days months like Feb.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsGrowth": ""
}

wikipediaPageviewsLastQuarter

The number of views of its Wikipedia page of the last quarter if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviewsLastQuarter": 0
}

wikipediaPageviewsLastQuarterGrowth

The quarter over quarter growth of wikipediaPageviews, where we count the increment of the number of page views of the second to last (full) quarter, compared with that of the last (full) quarter. If today was Aug 16th, 2022, the last complete quarter is Q2 (April, May, June). So it refers to the increment from Q1 to Q2, i.e., ( f(Q2) - f(Q1) ) ÷ f(Q1) x 100%.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsLastQuarterGrowth": ""
}

wikipediaPageviewsLastYear

The number of views of its Wikipedia page of the last year if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviewsLastYear": 0
}

wikipediaPageviewsLastYearGrowth

The year over year growth of wikipediaPageviews, where we count the monthly-rolling increment of the year before last than the last year. It today was Aug 16th, 2022, it is computed by comparing the numbers from Aug 2021 to July 2022 and from Aug 2020 to July 2021, i.e., ( f(Aug 2021 to July 2022) - f(Aug 2020 to July 2021) ) ÷ f(Aug 2020 to July 2021) x 100%.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsLastYearGrowth": ""
}

Updated 6 months ago