Degrees - Standardized Data API

The degrees API provides standardized member degree and diploma data across the LinkedIn platform.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name	Description
id	Degree ID.
$URN	Standardized degree URN.
name	Degree name in various locales. Represented as MultiLocaleString type.
alias	All aliases to this standardized degree name. Represented as an array of MultiLocaleString.
rollup	The general standardized degree category for the standardized degree. Represented as a degree URN. Optional.

GET

GET https://api.linkedin.com/v2/degrees/{id}?locale.language=en&locale.country=US

Parameters

Field Name	Sub-Field Name	Description
locale		The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "name": {
        "localized": {
            "en_US": "Bachelor of Architecture"
        }
    },
    "alias": [
        {
            "localized": {
                "en_US": "BArch"
            }
        },
        {
            "localized": {
                "en_US": "Bachelor of Architecture (B.Arch.)"
            }
        },
        {
            "localized": {
                "en_US": "Bachelor of Architecture (BArch)"
            }
        }
    ],
    "id": 258,
    "$URN": "urn:li:degree:258",
    "rollup": "urn:li:degree:200"
}

BATCH_GET

GET https://api.linkedin.com/v2/degrees?ids={id1}&ids={id2}&ids={id3}

Parameters

Field Name	Sub-Field Name	Description
locale		The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "statuses": {},
    "results": {
        "258": {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Architecture"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BArch"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Architecture (B.Arch.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Architecture (BArch)"
                    }
                }
            ],
            "id": 258,
            "$URN": "urn:li:degree:258",
            "rollup": "urn:li:degree:200"
        },
        "259": {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Applied Science"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BASc"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (B.A.Sc.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (BASc)"
                    }
                }
            ],
            "id": 259,
            "$URN": "urn:li:degree:259",
            "rollup": "urn:li:degree:200"
        }
    },
    "errors": {}
}

GET_ALL

GET https://api.linkedin.com/v2/degrees

Parameters

Field Name	Sub-Field Name	Description
locale		The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "elements": [
        {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Business Administration"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BAC"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of business"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of business management"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of science of business administration"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBA"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBS"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBM"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBus"
                    }
                },
                {
                    "localized": {
                        "en_US": "BSBA"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Business Administration (B.B.A.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Business Administration (BBA)"
                    }
                }
            ],
            "id": 450,
            "$URN": "urn:li:degree:450",
            "rollup": "urn:li:degree:200"
        },
        {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Applied Science"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BASc"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (B.A.Sc.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (BASc)"
                    }
                }
            ],
            "id": 259,
            "$URN": "urn:li:degree:259",
            "rollup": "urn:li:degree:200"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}