Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The degrees API provides standardized member degree and diploma data across the LinkedIn platform.
Degrees represent academic qualifications on LinkedIn member profiles (e.g., Bachelor's, Master's, PhD).
Note
This API may also be referred to as "Diploma" or "Academic Qualification" in other contexts.
The service currently provides the following methods:
- Get a degree by its ID.
- Get a list of degrees by their IDs.
- Get all degrees.
How to Retrieve Degree IDs
Use GET_ALL with pagination to list all degrees. Degree IDs may also appear in member profile education sections returned by other DMA APIs.
Permissions
| Permission | Description |
|---|---|
| r_dma_admin_pages_content | Retrieve your organization’s posts, comments, reactions, and other engagement data. Retrieve your organization’s pages and their reporting data (including follower, visitor and content analytics). |
See Organization Access Control for more information on company page roles.
Member Data Obfuscation
This DMA API has no member data that is obfuscated.
Schema
| Field | Format | Description | Required |
|---|---|---|---|
| id | integer | Degree ID | Yes |
| name | MultiLocaleString | Degree name in various locales | Yes |
| aliases | array of MultiLocaleString | All aliases to this standardized degree name | Yes |
| rollup | URN of entity type degree | The general standardized degree category for the standardized degree | Yes |
Retrieve Degrees
GET
Sample Request
Sample Response
{
"name": {
"localized": {
"en_US": "Bachelor of Architecture"
}
},
"alias": [
{
"localized": {
"en_US": "b of arch"
}
},
{
"localized": {
"en_US": "bach of arch"
}
},
{
"localized": {
"en_US": "bachelor of architecture(b.arch.)"
}
},
{
"localized": {
"en_US": "bachelor of architecture(barch)"
}
}
],
"id": 258,
"rollup": "urn:li:degree:200"
}
Query Parameters
| Field Name | Sub-Field Name | Description | Required | Example |
|---|---|---|---|---|
| locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. | No | locale=(language:en,country:US) |
|
| language | A lowercase two-letter language code as defined by ISO-639. | No | language:en |
|
| country | An uppercase two-letter country code as defined by ISO-3166. | No | country:US |
BATCH_GET
Sample Request
GET https://api.linkedin.com/rest/dmaDegrees?ids=List(DEGREE_ID_1,DEGREE_ID_2)&locale=(language:en,country:US)
Sample Response
{
"results": {
"258": {
"name": {
"localized": {
"en_US": "Bachelor of Architecture"
}
},
"alias": [
{
"localized": {
"en_US": "b of arch"
}
},
{
"localized": {
"en_US": "bach of arch"
}
},
{
"localized": {
"en_US": "bachelor of architecture(b.arch.)"
}
},
{
"localized": {
"en_US": "bachelor of architecture(b.arch)"
}
}
],
"id": 258,
"rollup": "urn:li:degree:200"
},
"102": {
"name": {
"localized": {
"en_US": "Associate of Mathematics and Physics"
}
},
"alias": [],
"id": 102,
"rollup": "urn:li:degree:100"
}
},
"statuses": {},
"errors": {}
}
Query Parameters
| Field Name | Sub-Field Name | Description | Required | Example |
|---|---|---|---|---|
| ids | List of degree IDs | Yes | ids=List(DEGREE_ID_1,DEGREE_ID_2,DEGREE_ID_3) |
|
| locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. | No | locale=(language:en,country:US) |
|
| language | A lowercase two-letter language code as defined by ISO-639. | No | language:en |
|
| country | An uppercase two-letter country code as defined by ISO-3166. | No | country:US |
GET_ALL
Sample Request
GET https://api.linkedin.com/rest/dmaDegrees?start=0&count=5&locale=(language:en,country:US)
Sample Response
{
"paging": {
"start": 4,
"count": 2,
"links": [
{
"type": "application/json",
"rel": "prev",
"href": "/rest/dmaDegrees?start=2&count=2&locale=(country:US,language:en)"
},
{
"type": "application/json",
"rel": "next",
"href": "/rest/dmaDegrees?start=6&count=2&locale=(country:US,language:en)"
}
]
},
"elements": [
{
"name": {
"localized": {
"en_US": "Associate of Maritime"
}
},
"alias": [],
"id": 2052,
"rollup": "urn:li:degree:100"
},
{
"name": {
"localized": {
"en_US": "Middle School Diploma"
}
},
"alias": [
{
"localized": {
"en_US": "5th grade"
}
},
{
"localized": {
"en_US": "6th grade"
}
},
{
"localized": {
"en_US": "7th grade"
}
},
{
"localized": {
"en_US": "8th grade"
}
},
{
"localized": {
"en_US": "primary school"
}
}
],
"id": 5,
"rollup": "urn:li:degree:5"
}
]
}
Query Parameters
| Field Name | Sub-Field Name | Description | Required | Example |
|---|---|---|---|---|
| locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not supported. | No | locale=(language:en,country:US) |
|
| language | A lowercase two-letter language code as defined by ISO-639. | No | language:en |
|
| country | An uppercase two-letter country code as defined by ISO-3166. | No | country:US |
|
| start | The index of the first item you want results for. Defaults to 0 |
No | start=0 |
|
| count | The number of items you want included on each page of results. There could be fewer items remaining than the value you specify. Defaults to 10 |
No | count=3 |
API Error Details
| HTTP Status Code | ERROR MESSAGE | DESCRIPTION | ERROR RESOLUTION |
|---|---|---|---|
| 400 | BAD_REQUEST | Invalid request. Please verify the API input. | Use a valid URL and parameters. |
| 401 | EMPTY_ACCESS_TOKEN | Empty or expired OAuth2 access token. | Use a valid member access token. |
| 403 | FORBIDDEN | Access to the resource is forbidden. Please check your permissions for this resource. | Make sure your developer application is provisioned with the required permissions. |
| 404 | NOT_FOUND | Could not find entity. | Verify the provided entity ID is correct. |
| 500 | INTERNAL_SERVER_ERROR | Server encountered an unexpected condition that prevented it from fulfilling the request. | N/A |