openaire-graph-docs/versioned_docs/version-10.0.0/apis/graph-api/getting-a-single-entity.md

Getting a single entity

This is a guide on how to retrieve detailed information on a single entity using the OpenAIRE Graph API.

Endpoints

Currently, the Graph API supports the following entity types:

• Research products - endpoint: GET /researchProducts/{id}
• Organizations - endpoint: GET /organizations/{id}
• Data sources - endpoint: GET /dataSources/{id}
• Projects - endpoint: GET /projects/{id}

You can retrieve the data of a single entity by providing the entity's OpenAIRE identifier (id) in the corresponding endpoint. The OpenAIRE id is the primary key of an entity in the OpenAIRE Graph.

:::note Note that if you want to retrieve multiple entities based on their OpenAIRE ids, you can use the search endpoints and filter by the id field using OR. :::

Response

The response of the Graph API is a Research product, Organization, Data Source, or Project, depending on the endpoint used.

Example

In order to retrieve the research product with OpenAIRE id: doi_dedup___::2b3cb7130c506d1c3a05e9160b2c4108, you have to perform the following API call:

https://api-beta.openaire.eu/graph/researchProducts/doi_dedup___::a55b42c0d32a4a24cf99e621623d110e

This will return all the data of the research product with the provided identifier:

{
  id: "doi_dedup___::a55b42c0d32a4a24cf99e621623d110e",
  mainTitle: "OpenAIRE Graph Dataset",
  description: [
    "The OpenAIRE Graph is exported as several dataseta, so you can download the parts you are interested into. <strong>publication_[part].tar</strong>: metadata records about research literature (includes types of publications listed here)<br> <strong>dataset_[part].tar</strong>: metadata records about research data (includes the subtypes listed here) <br> <strong>software.tar</strong>: metadata records about research software (includes the subtypes listed here)<br> <strong>otherresearchproduct_[part].tar</strong>: metadata records about research products that cannot be classified as research literature, data or software (includes types of products listed here)<br> <strong>organization.tar</strong>: metadata records about organizations involved in the research life-cycle, such as universities, research organizations, funders.<br> <strong>datasource.tar</strong>: metadata records about data sources whose content is available in the OpenAIRE Graph. They include institutional and thematic repositories, journals, aggregators, funders' databases.<br> <strong>project.tar</strong>: metadata records about project grants.<br> <strong>relation_[part].tar</strong>: metadata records about relations between entities in the graph.<br> <strong>communities_infrastructures.tar</strong>: metadata records about research communities and research infrastructures Each file is a tar archive containing gz files, each with one json per line. Each json is compliant to the schema available at http://doi.org/10.5281/zenodo.8238874. The documentation for the model is available at https://graph.openaire.eu/docs/data-model/ Learn more about the OpenAIRE Graph at https://graph.openaire.eu. Discover the graph's content on OpenAIRE EXPLORE and our API for developers."
  ],
  type: "dataset",
  publicationDate: "2023-08-08",
  publisher: "Zenodo",
  id: [
    {
      scheme: "Digital Object Identifier",
      value: "10.5281/zenodo.8217359"
    }
  ],
  // for brevity, the rest of the fields are omitted
}