Fields of Study

Try in Postman

The Fields of Study API provides standardized member curriculum data across the LinkedIn platform. This API doesn’t share member personal data as part of the API response.

Fields of Study represent academic disciplines on LinkedIn member profiles (e.g., "Business Administration and Management", "Computer Science"). The rollupIds field contains URNs of general standardized categories that group related fields of study.

The service currently provides the following methods:

  • Get a single FieldOfStudy entity.
  • Get All FieldOfStudy that are available in the taxonomy.
  • Batch Get FieldsOfStudy for the set of fieldOfStudyIds.

How to Retrieve Field of Study IDs

Use GET_ALL with pagination to list all fields of study. Field of Study IDs also appear in member profile education sections returned by other DMA APIs. The rollupIds in the response are themselves Field of Study URNs that can be resolved via this same API.

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 int The Field of study ID. Yes
name MultiLocaleString Field of Study name in various locales. Represented as MultiLocaleString type. Yes
rollupIds Array of fieldOfStudy URNs The general standardized Field of Study categories. Yes

Retrieve Fields of Study Data

GET

Sample Request

GET https://api.linkedin.com/rest/dmaFieldsOfStudy/{FIELD_OF_STUDY_ID}?locale=(language:en,country:US)

Sample Response

{
  "name": {
    "localized": {
      "en_US": "Business Administration and Management, General"
    }
  },
  "rollupIds": [
    "urn:li:fieldOfStudy:101408",
    "urn:li:fieldOfStudy:101406"
  ],
  "id": 101409
}

Parameters

Name Sub-Field Name Description Required Example
locale The locale the Field of Study data is requested in. en_US locale is used if locale is not provided or 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/dmaFieldsOfStudy?locale=(language:en,country:US)&start=2&count=5

Sample Response

{
  "paging": {
    "start": 2,
    "count": 5,
    "links": [
      {
        "type": "application/json",
        "rel": "prev",
        "href": "/rest/dmaFieldsOfStudy?start=0&count=5&locale=(country:jp,language:ja)"
      },
      {
        "type": "application/json",
        "rel": "next",
        "href": "/rest/dmaFieldsOfStudy?start=7&count=5&locale=(country:jp,language:ja)"
      }
    ]
  },
  "elements": [
    {
      "name": {
        "localized": {
          "en_US": "Agricultural Business and Management"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100003
    },
    {
      "name": {
        "localized": {
          "en_US": "Agribusiness/Agricultural Business Operations"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100003",
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100004
    },
    {
      "name": {
        "localized": {
          "en_US": "Agricultural Economics"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100003",
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100005
    },
    {
      "name": {
        "localized": {
          "en_US": "Farm/Farm and Ranch Management"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100003",
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100006
    },
    {
      "name": {
        "localized": {
          "en_US": "Agricultural/Farm Supplies Retailing and Wholesaling"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100003",
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100007
    }
  ]
}

Parameters

Name Sub-Field Name Description Required Example
locale The locale the Field of Study data is requested in. en_US locale is used if locale is not provided or 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=1
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=4

BATCH_GET

Sample Request

GET https://api.linkedin.com/rest/dmaFieldsOfStudy?ids=List(id_1,id_2,id_3)&locale=(language:en,country:US)

Sample Response

{
  "results": {
    "100009": {
      "name": {
        "localized": {
          "en_US": "Agricultural Mechanization"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100001"
      ],
      "id": 100009
    },
    "100123": {
      "name": {
        "localized": {
          "en_US": "Tibetan Studies"
        }
      },
      "rollupIds": [
        "urn:li:fieldOfStudy:100092",
        "urn:li:fieldOfStudy:100091"
      ],
      "id": 100123
    }
  },
  "statuses": {},
  "errors": {
    "333": {
      "code": "NOT_FOUND",
      "message": "Could not find field of study for fieldOfStudy id: 333",
      "status": 404
    }
  }
}

Parameters

Name Sub-Field Name Description Required Example
ids List of Field of Study ids to query for Yes ids=List(ID_1, ID_2, ...)
locale The locale the Field of Study data is requested in. en_US locale is used if locale is not provided or 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

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
  • Last updated on