Organization Lookup
Warning
Deprecation Notice
The Marketing Version 202308 (Marketing August 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details.
If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.
The Organization Lookup API searches organizations and brand profiles.
Unless otherwise noted, the following rules apply when specifying input parameters:
- All strings are case-insensitive.
- Multiple words should be joined with a space. The input is URL encoded where spaces are translated to "%20". For example, Apple Inc. is encoded to
Apple%20Inc
. - If a search includes multiple words, the complete string is searched.
- Wildcards and boolean logic are not supported:
*
,?
,AND
, andOR
For information on finding organizations with partial or incomplete information, see the Company Search documentation.
Permissions
Permission | Description |
---|---|
rw_organization_admin | Manage organization pages and retrieve reporting data |
r_compliance | Retrieve posts, comments, and likes on behalf of an authenticated member for compliance monitoring and archiving. This is a private permission and access is granted to select developers. |
Note
Organization lookup API is protected by 3-legged OAuth token. For more information, Authorization Code Flow (3-legged OAuth).
Admin and Non-Admin Access
Important
Some of these API calls require that the authenticated member has the role type ADMINISTRATOR
for the requested organization or organization brand. For information on how to retrieve roles through the API, see Organization Access Control.
APIs that do not require administrative access will only return the following fields:
id
name
localizedName
localizedWebsite
vanityName
logoV2
locations
primaryOrganizationType
APIs that require administrative access will return all available Organization and Organization Brand fields.
Schema
Find detailed schema information, see Schema Information.
Retrieve Organizations
Use the Organization Lookup API to find organizations using an organization id, vanity name, or email domain.
Organization URNs are in the format urn:li:organization:{organization id}
and represent a LinkedIn Company Page.
Retrieve an Administered Organization
You can use the organization ID
to look up organization information on behalf of authenticated members with role type ADMINISTRATOR
for that organization. API calls with insufficient permissions return 403 Forbidden
.
Sample Request
GET https://api.linkedin.com/rest/organizations/{organization ID}
Sample Request Example
Sample Response
{
"vanityName": "firstdemocompany",
"localizedName": "FirstDemoCompany",
"groups": [],
"versionTag": "111146657",
"coverPhotoV2": {
"cropped": "urn:li:digitalmediaAsset:C561BAQHqQYsCLYiAnA",
"original": "urn:li:digitalmediaAsset:C561BAQHqQYsCLYiAnA",
"cropInfo": {
"x": 0,
"width": 800,
"y": 108,
"height": 135
}
},
"organizationType": "SELF_EMPLOYED",
"defaultLocale": {
"country": "US",
"language": "en"
},
"alternativeNames": [],
"specialties": [],
"staffCountRange": "SIZE_1",
"localizedSpecialties": [],
"industries": [
"urn:li:industry:4"
],
"name": {
"localized": {
"en_US": "FirstDemoCompany"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "NONE",
"locations": [],
"id": 79988552,
"$URN": "urn:li:organization:79988552"
}
Batch Get Administered Organizations
You can fetch a list of organizations with the associated IDs on behalf of authenticated members with role type ADMINISTRATOR
for those organizations. API calls with insufficient permissions receive a 403 Forbidden
response.
Note
The request must include a header for Restli Protocol 2.0.0 as X-Restli-Protocol-Version: 2.0.0
.
Sample Request
GET https://api.linkedin.com/rest/organizations?ids=List({organization ID1, organization ID2..})
Sample Request Example
Sample Response
{
"results": {
"79988552": {
"vanityName": "firstdemocompany",
"localizedName": "FirstDemoCompany",
"groups": [],
"versionTag": "111146657",
"coverPhotoV2": {
"cropped": "urn:li:digitalmediaAsset:C561BAQHqQYsCLYiAnA",
"original": "urn:li:digitalmediaAsset:C561BAQHqQYsCLYiAnA",
"cropInfo": {
"x": 0,
"width": 800,
"y": 108,
"height": 135
}
},
"organizationType": "SELF_EMPLOYED",
"defaultLocale": {
"country": "US",
"language": "en"
},
"alternativeNames": [],
"specialties": [],
"localizedSpecialties": [],
"industries": [
"urn:li:industry:4"
],
"name": {
"localized": {
"en_US": "FirstDemoCompany"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "NONE",
"locations": [],
"id": 79988552
}
},
"statuses": {
"79988552": 200,
"27056405": 403
},
"errors": {
"27056405": {
"message": "Viewer don't have permission to the ADMIN_ONLY VisibilityReduction for urn:li:organization:27056405",
"status": 403
}
}
}
Batch Get Non-Administered Organizations
You can fetch a list of organizations the authenticated member does not administer using the following API. The returned fields are more limited than the equivalent endpoint for administered organizations.
The request must include a header for Restli Protocol 2.0.0 as X-Restli-Protocol-Version: 2.0.0
.
Note
organizationsLookup
usage does not require administrator access.
Sample Request
GET https://api.linkedin.com/rest/organizationsLookup?ids=List(id1,id2, ...)
Sample Request Example
Sample Response
{
"results": {
"79988552": {
"name": {
"localized": {
"en_US": "FirstDemoCompany"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "NONE",
"vanityName": "firstdemocompany",
"locations": [],
"localizedName": "FirstDemoCompany",
"id": 79988552
},
"90966477": {
"vanityName": "devtestcocompany",
"localizedName": "Devtestco",
"name": {
"localized": {
"en_US": "Devtestco"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "NONE",
"locations": [],
"id": 90966477,
"localizedWebsite": "LinkedIn.com"
}
},
"statuses": {
"79988552": 200,
"90966477": 200
},
"errors": {}
}
Retrieve Organization Details by URN Decoration
You can use decoration on any organization URN using the projection
query parameter to request specific fields. Decoration is limited to selecting Non-Admin Fields.
For example:
&projection=(elements*(entity~(vanityName)))
Sample Response
{
"elements": [
{
"entity~": {
"vanityName": "linked-it"
},
"entity": "urn:li:organization:1032984"
}
]
}
Look Up Organization Primary Type
Retrieve an organization's primary type by requesting the primaryTypeOrganization
field when looking up an organization.
Sample Request
GET https://api.linkedin.com/rest/organizations/1000?projection=(primaryOrganizationType)
Sample Request Example
Sample Response
{
"primaryOrganizationType": "NONE"
}
Find Organization by Vanity Name
You can look up organizations using vanityName
to retrieve Non-Admin Fields.
The API can return schools (such as Universities), organization brands (previously known as Showcase Pages), and organizations (companies). To differentiate between entities, primaryOrganizationType
field returns one of the following possible organizational entity values:
- SCHOOL
- BRAND
- NONE - no primary type
Sample API Calls to Lookup
Find an Organization - LinkedIn
GET https://api.linkedin.com/rest/organizations?q=vanityName&vanityName=LinkedIn
Find a Brand - LinkedIn Marketing Solutions
GET https://api.linkedin.com/rest/organizations?q=vanityName&vanityName=linkedin-marketing-solutions
Find a School - Boise State University
GET https://api.linkedin.com/rest/organizations?q=vanityName&vanityName=boisestate
Find an Organization - LinkedIn
GET https://api.linkedin.com/v2/organizations?q=vanityName&vanityName=LinkedIn
Find a Brand - LinkedIn Marketing Solutions
GET https://api.linkedin.com/v2/organizations?q=vanityName&vanityName=linkedin-marketing-solutions
Find a School - Boise State University
GET https://api.linkedin.com/v2/organizations?q=vanityName&vanityName=boisestate
Sample Response - For Boise State University Lookup
{
"paging": {
"start": 0,
"count": 10,
"links": [],
"total": 1
},
"elements": [{
"vanityName": "boisestate",
"localizedName": "Boise State University",
"schoolAttributes": {
"hierarchyClassification": "UNIVERSITY",
"type": "PUBLIC",
"yearLevel": "FOUR_YEAR",
"legacySchool": "urn:li:school:18235"
},
"name": {
"localized": {
"en_US": "Boise State University"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "SCHOOL",
"locations": [{
"address": {
"geographicArea": "Idaho",
"country": "US",
"city": "Boise",
"line1": "301 S. CAPITOL BLVD.",
"postalCode": "83702"
},
"staffCountRange": "SIZE_11_TO_50",
"geoLocation": "urn:li:geo:100754108",
"phoneNumber1": {
"number": "2084263335"
},
"locationType": "OTHER",
"description": {
"localized": {
"en_US": "Boise State Downtown"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"localizedDescription": "Boise State Downtown",
"streetAddressFieldState": "UNSET_OPT_OUT"
}, {
"address": {
"geographicArea": "Idaho",
"country": "US",
"city": "Nampa",
"line2": "Nampa Campus Aspen Classroom Bldg.",
"line1": "6002 Birch Lane",
"postalCode": "83687"
},
"staffCountRange": "SIZE_1",
"geoLocation": "urn:li:geo:105011711",
"streetAddressFieldState": "UNSET_OPT_OUT"
}],
"id": 11832,
"localizedWebsite": "https://boisestate.edu",
"logoV2": {
"cropped": "urn:li:digitalmediaAsset:C4D0BAQE6V6rj_w1yVQ",
"original": "urn:li:digitalmediaAsset:C4D0BAQE6V6rj_w1yVQ",
"cropInfo": {
"x": 0,
"width": 0,
"y": 0,
"height": 0
}
}
}]
}
How to Use the API Response for Finding School Organization URN
The API returns an id
field, which is the organization URN (urn:li:organization:11832) for Boise State:
Caution
Use id
field as shown above for school organization. The legacySchool
field has a school URN that has near term plans for deprecation,
e.g. "legacySchool": "urn:li:school:18235"
Warning
Deprecation Notice
We have discontinued Find Organization by Email Domain API Finder
starting with version 202408
and above.
Find Organization by Email Domain
You can look up organizations using emailDomain
to retrieve Non-Admin Fields. This returns an array of organizations that match the specified email domain.
Sample Request
GET https://api.linkedin.com/rest/organizations?q=emailDomain&emailDomain=linkedin.com
Sample Request Example
GET https://api.linkedin.com/rest/organizations?q=emailDomain&emailDomain=linkedin.com
Sample Response
{
"elements": [
{
"id": 0000,
"localizedName": "LinkedIn",
"logoV2": {
"cropped": "urn:li:digitalmediaAsset:C4D0BAQHnSQoLUKZxqA",
"cropInfo": {
"x": 0,
"width": 0,
"y": 0,
"height": 0
}
},
"name": {
"localized": {
"cs_CZ": "LinkedIn",
"da_DK": "LinkedIn",
"de_DE": "LinkedIn",
"en_US": "LinkedIn",
"es_ES": "LinkedIn",
"fr_FR": "LinkedIn",
"in_ID": "LinkedIn",
"it_IT": "LinkedIn",
"ja_JP": "LinkedIn",
"ko_KR": "LinkedIn",
"ms_MY": "LinkedIn",
"nl_NL": "LinkedIn",
"no_NO": "LinkedIn",
"pl_PL": "LinkedIn",
"pt_BR": "LinkedIn",
"ro_RO": "LinkedIn",
"ru_RU": "LinkedIn",
"sv_SE": "LinkedIn",
"th_TH": "LinkedIn",
"tr_TR": "LinkedIn",
"zh_CN": "LinkedIn (\u9886\u82f1)",
"zh_TW": "LinkedIn"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"vanityName": "linkedin"
}
],
"paging": {
"total": 10,
"count": 10,
"start": 0,
"links": []
}
}
GET https://api.linkedin.com/v2/organizations?q=emailDomain&emailDomain=linkedin.com
Sample Response
{
"elements": [
{
"id": 0000,
"localizedName": "LinkedIn",
"logoV2": {
"cropped": "urn:li:digitalmediaAsset:C4D0BAQHnSQoLUKZxqA",
"cropInfo": {
"x": 0,
"width": 0,
"y": 0,
"height": 0
}
},
"name": {
"localized": {
"cs_CZ": "LinkedIn",
"da_DK": "LinkedIn",
"de_DE": "LinkedIn",
"en_US": "LinkedIn",
"es_ES": "LinkedIn",
"fr_FR": "LinkedIn",
"in_ID": "LinkedIn",
"it_IT": "LinkedIn",
"ja_JP": "LinkedIn",
"ko_KR": "LinkedIn",
"ms_MY": "LinkedIn",
"nl_NL": "LinkedIn",
"no_NO": "LinkedIn",
"pl_PL": "LinkedIn",
"pt_BR": "LinkedIn",
"ro_RO": "LinkedIn",
"ru_RU": "LinkedIn",
"sv_SE": "LinkedIn",
"th_TH": "LinkedIn",
"tr_TR": "LinkedIn",
"zh_CN": "LinkedIn (\u9886\u82f1)",
"zh_TW": "LinkedIn"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"vanityName": "linkedin"
}
],
"paging": {
"total": 10,
"count": 10,
"start": 0,
"links": []
}
}
Retrieve Organization Follower Count
The Organization Network Size API provides the ability to retrieve the number of first-degree connections (followers) for any organization.
Sample Request
GET https://api.linkedin.com/rest/networkSizes/urn:li:organization:1234567?edgeType=COMPANY_FOLLOWED_BY_MEMBER
Sample Response
{
"firstDegreeSize": 219145
}
Note
The ?edgeType= parameter options for CompanyFollowedByMember for the /networkSizes endpoint changes to COMPANY_FOLLOWED_BY_MEMBER starting in v202305. Prior versions (≤ v202304) still utilize CompanyFollowedByMember but the two options are not retrocompatible.
Retrieve Organization Brands
Use the Organization Lookup API to find organization brands using an organization brand ID, parent organization ID, or a vanity name.
Organization brand URNs are in the format urn:li:organizationBrand:{id}
and represent LinkedIn Showcase Pages.
Note
organizationsBrands Lookup
usage does not require administrator access.
Retrieve an Administered Organization Brand
You can use the organization brand ID
to lookup Organization Brands information on behalf of authenticated members with role type ADMINISTRATOR
for that brand. API calls with insufficient permissions receive a 403 Forbidden
response.
Sample Request
GET https://api.linkedin.com/rest/organizationBrands/{organization brand ID}
Sample Request Example
Sample Response
{
"vanityName": "internal-ei-demo",
"localizedName": "Internal_EI_Demo",
"website": {
"localized": {
"en_US": "https://internal-ei-test-company.com"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"groups": [],
"versionTag": "3061199585",
"defaultLocale": {
"country": "US",
"language": "en"
},
"alternativeNames": [],
"specialties": [],
"parentRelationship": {
"relationshipStatus": "ACTIVE",
"parent": "urn:li:organization:79988552"
},
"localizedSpecialties": [],
"industries": [
"urn:li:industry:84"
],
"name": {
"localized": {
"en_US": "Internal_EI_Demo"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"id": 89758488,
"$URN": "urn:li:organizationBrand:89758488",
"autoCreated": false,
"localizedWebsite": "https://internal-ei-test-company.com"
}
Batch Get Administered Organization Brands
You can fetch a list of Organization Brands information on behalf of authenticated members with role type ADMINISTRATOR
for those brands. API calls with insufficient permissions receive a 403 Forbidden
response.
The request must include a header for Restli Protocol 2.0.0 as X-Restli-Protocol-Version: 2.0.0
.
Sample Request
GET https://api.linkedin.com/rest/organizationBrands?ids=List(id1,id2,...)
Sample Request Example
Sample Response
{
"results": {
"89757515": {
"vanityName": "internal-ei-testcompany",
"localizedName": "Internal_EI_TestCompany",
"groups": [],
"versionTag": "584589141",
"defaultLocale": {
"country": "US",
"language": "en"
},
"alternativeNames": [],
"specialties": [],
"parentRelationship": {
"relationshipStatus": "ACTIVE",
"parent": "urn:li:organization:79988552"
},
"localizedSpecialties": [],
"industries": [
"urn:li:industry:84"
],
"name": {
"localized": {
"en_US": "Internal_EI_TestCompany"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"id": 89757515,
"autoCreated": false
},
"89758488": {
"vanityName": "internal-ei-demo",
"localizedName": "Internal_EI_Demo",
"website": {
"localized": {
"en_US": "https://internal-ei-test-company.com"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"groups": [],
"versionTag": "3061199585",
"defaultLocale": {
"country": "US",
"language": "en"
},
"alternativeNames": [],
"specialties": [],
"parentRelationship": {
"relationshipStatus": "ACTIVE",
"parent": "urn:li:organization:79988552"
},
"localizedSpecialties": [],
"industries": [
"urn:li:industry:84"
],
"name": {
"localized": {
"en_US": "Internal_EI_Demo"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"id": 89758488,
"autoCreated": false,
"localizedWebsite": "https://internal-ei-test-company.com"
}
},
"statuses": {
"89757515": 200,
"1234567": 403,
"89758488": 200
},
"errors": {
"1234567": {
"message": "Viewer don't have permission to the ADMIN_ONLY VisibilityReduction for urn:li:organization:1234567",
"status": 403
}
}
}
Find Administered Organization Brands by Parent Organization
You can use this API to look up information about Organization Brands using the parent organization
URN on behalf of authenticated members with role type ADMINISTRATOR
. This returns an array of brands that belong to the specified parent organization and only brands that are administered by the authenticated member are returned.
Sample Request
GET https://api.linkedin.com/rest/organizations?q=parentOrganization&parent={organization URN}
Sample Request Example
Sample Response
{
"paging": {
"start": 0,
"count": 10,
"links": [],
"total": 2
},
"elements": [
{
"name": {
"localized": {
"en_US": "Internal_EI_Demo"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"vanityName": "internal-ei-demo",
"locations": [],
"localizedName": "Internal_EI_Demo",
"id": 89758488
},
{
"name": {
"localized": {
"en_US": "Internal_EI_TestCompany"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"vanityName": "internal-ei-testcompany",
"locations": [],
"localizedName": "Internal_EI_TestCompany",
"id": 89757515
}
]
}
Batch Get Non-Administered Organization Brands
You can fetch a list of Organization Brands that the authenticated member does not administer using the following API. The returned fields are more limited than the equivalent endpoint for administered organization brands.
The request must include a header for Restli Protocol 2.0.0 as X-Restli-Protocol-Version: 2.0.0
.
Sample Request
GET https://api.linkedin.com/rest/organizationBrandsLookup?ids=List(id1,id2,...)
Sample Request Example
Sample Response
{
"results": {
"35625943": {
"name": {
"localized": {
"en_US": "Test Showcase"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"vanityName": "test-showcase",
"localizedName": "Test Showcase",
"id": 35625943
},
"5025865": {
"vanityName": "lms-test-co",
"localizedName": "LinkedIn Demo Account",
"name": {
"localized": {
"ja_JP": "テスト",
"en_US": "LinkedIn Demo Account"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"id": 5025865,
"localizedWebsite": "http://www.linkedin-ei123.com",
"logoV2": {
"cropped": "urn:li:digitalmediaAsset:C510BAQEfmCIulaw0Qw",
"original": "urn:li:digitalmediaAsset:C510BAQEfmCIulaw0Qw",
"cropInfo": {
"x": 0,
"width": 1024,
"y": 0,
"height": 1024
}
}
}
},
"statuses": {
"35625943": 200,
"5025865": 200
},
"errors": {}
}
Retrieve Organization Brand Details by URN Decoration
You can use decoration on any organization brand URN using the projection
query parameter to request specific fields. Decoration is limited to selecting Non-Admin Fields.
For example:
&projection=(elements*(entity~(vanityName)))
Sample Response
{
"elements": [
{
"entity~": {
"vanityName": "linked-it"
},
"entity": "urn:li:organizationBrand:11111111"
}
]
}
Find Organization Brand by Vanity Name
You can look up organization brands using vanityName
to retrieve Non-Admin Fields.
Sample Request
GET https://api.linkedin.com/rest/organizationBrands?q=vanityName&vanityName=Linkedin
Sample Request Example
Sample Response
{
"paging": {
"start": 0,
"count": 10,
"links": [],
"total": 1
},
"elements": [
{
"name": {
"localized": {
"en_US": "Company LGF Showcase"
},
"preferredLocale": {
"country": "US",
"language": "en"
}
},
"primaryOrganizationType": "BRAND",
"vanityName": "company-lgf-showcase",
"localizedName": "Company LGF Showcase",
"id": 35625943
}
]
}
Retrieve Organization Logos & Cover Photos
The Organization Lookup API returns the following media fields for both organizations and organization brands:
The value formats are digitalmediaAsset
URNs. For example, urn:li:digitalmediaAsset:123ABC
. These URNs need to be decorated in order to return image URLs. Include ~:playableStreams
in the projection
parameter to request the image URLs. For example:
projection=(elements(*(logoV2(original~:playableStreams))))
For more information, see Digital Media Asset URNs.
Sample Request
API Error Details
HTTP STATUS CODE | ERROR MESSAGE | ERROR DESCRIPTION | RESOLUTION |
---|---|---|---|
403 | Viewer don't have permission to the ADMIN_ONLY VisibilityReduction for urn:li:organization:xxxxx | Viewing Member is not an Admin of the respective Organization. | Lookup for the list of Organization IDs for which the viewing member is an Admin. |
404 | Organization/Organization brand xxxx is inactive | Requested Organization/Organization Brand is either inactive or not available. | Provide the correct Organization ID or Organization Brand ID. |
Schema Information
Organization
Field Name | Type | Description | Admin Only |
---|---|---|---|
alternativeNames | LocaleString [] | Alternative names of the entity. There can be multiple names per locale. | True |
coverPhotoV2 | CroppedImage | The entity's background cover image. The sizes may vary, so clients should handle the given height and width accordingly. | True |
defaultLocale | Locale | Default locale of the entity. | True |
deleted.time | long | Deleted timestamp | True |
description | MultiLocaleString | Description for the entity. | True |
foundedOn | Date | Date when the entity was founded. | True |
groups | GroupUrn[] | Groups featured by the organizational entity. Default to empty array. | True |
id | long | Unique identifier for the entity. | False |
industries | IndustryURN[] | The industries associated with the entity. | True |
localizedDescription | string | The locale-specific description of the entity. | True |
localizedName | string | The locale-specific name of the entity. | False |
localizedSpecialties | string[] | The locale-specific, admin-defined specialty tags of the entity. | True |
localizedWebsite | string | The locale-specific website of the entity. | False |
locations | LocationInfo[] | List of locations for the entity. | False |
name | MultiLocaleString | Entity's name. | False |
parentRelationship. parent | string | URN of the parent organization. | True |
parentRelationship. organizationRelationshipType | string | Type of relationship from child to parent organizations. Possible values: |
True |
parentRelationship. relationshipStatus | string | The status of a relationship between organizations. Possible values: |
True |
specialties.tags[] | string [] | Admin-defined specialty tags of the entity. | True |
vanityName | string | Entity's unique name used in URLs. | False |
versionTag | string | Tag indicating version. | True |
website | MultiLocaleString | Entity's website. | True |
staffCountRange | string | Range of the number of staff associated with this entity. Possible values: |
True |
schoolAttributes | SchoolAttributes | School-specific attributes of the organization. If this field exists, then this entity is a school. | True |
overviewPhotoV2 | CroppedImage | The image used in the Overview tab on the organization's page. | True |
logoV2 | CroppedImage | The entity’s logo. The sizes may vary greatly, i.e., 50x50, 100x60, 400x400, so clients should handle the given height and width accordingly. | False |
organizationStatus | string | Status of the organization, such as operating or out of business. Possible values: |
True |
organizationType | string | Type of organization. Possible values: |
True |
primaryOrganizationType | string | Type of primary organization being used in the lookup. Possible values: |
False |
Organization Brand
Field Name | Type | Description | Admin Only |
---|---|---|---|
alternativeNames | LocaleString [] | Alternative names of the entity. There can be multiple names per locale. | True |
coverPhotoV2 | CroppedImage | The entity's background cover image. The sizes may vary, so clients should handle the given height and width accordingly. | True |
defaultLocale | Locale | Default locale of the entity. | True |
description | MultiLocaleString | Map of locale to localized entity's description. | True |
foundedOn | Date | Date when the entity was founded. | True |
id | long | Unique identifier for the entity. | False |
industries | IndustryURN[] | The industries associated with the entity. | True |
localizedDescription | string | The locale-specific description of the entity. | True |
localizedName | string | The locale-specific name of the entity. | False |
localizedSpecialties | string[] | The locale-specific, admin-defined specialty tags of the entity. | True |
localizedWebsite | string | The locale-specific website of the entity. | False |
name | MultiLocaleString | Entity's name. | False |
parentRelationship. parent | string | URN of the parent organization. | True |
specialties.tags[] | string [] | Admin-defined specialty tags of the entity. | True |
vanityName | string | Entity's unique name used in URLs. | False |
versionTag | string | Tag indicating version. | True |
website | MultiLocaleString | Entity's website. | True |
logoV2 | CroppedImage | The entity’s logo. The sizes may vary greatly, i.e., 50x50, 100x60, 400x400, so clients should handle the given height and width accordingly. | False |
pinnedPost | string | The URN of the entity's pinned post. | True |
autoCreated | boolean | Whether the entity was auto-created. | True |
CroppedImage
Field Name | Type | Description |
---|---|---|
height | int | Height of the image |
width | int | Width of the image |
x | int | X coordinate of the corner |
y | int | Y coordinate of the corner |
cropped | string | Location of the cropped image |
original | string | Location of the original image |
Date
Field Name | Type | Description |
---|---|---|
day | int | Day |
month | int | Month |
year | int | Year |
Locale
Field Name | Type | Description |
---|---|---|
country | string | An uppercase, two-letter country code as defined by ISO-3166. |
language | string | A lowercase, two-letter language code as defined by ISO-639. |
LocaleString
Field Name | Type | Description |
---|---|---|
locale | Locale | Locale key |
value | string | String value for locale |
MultiLocaleString
Field Name | Type | Description |
---|---|---|
localized | map (string->string) | Map of locale to localized entity's description. |
preferredLocale | string | The preferred locale to use for entity’s description. |
SchoolAttributes
Field Name | Type | Description |
---|---|---|
hierarchyClassification | string | The classification for school hierarchy. Possible values: |
legacySchool | string | Legacy school urn for the organization. |
type | string | The type of institution. Possible values: |
yearLevel | string | Classification of the length of the institution's educational programs. These levels are defined by the National Center for Education Statistics (http://nces.ed.gov/pubs2015/2015097rev.pdf). Possible values: |