Nothing Special   »   [go: up one dir, main page]

Skip to content

Funders

Query and retrieve entries from the funders vocabulary.

Search funders

GET /api/funders

Parameters

Name Type Location Description
q string query Search query used to filter results.
suggest string query "Search as you type" query.
sort string query Sort search results. Built-in options are "bestmatch", "name", "newest", "oldest" (default: "bestmatch" or "name").
size integer query Specify number of items in the results page (default: 10).
page integer query Specify the page of results.
accept string header - application/json

Sort options for funders are configured on the vocabulary service class. Note that "bestmatch" is only available as a sort option on requests that provide a query string as a q parameter. Otherwise "bestmatch" is ignored and the default "name" sort is used.

Query string syntax

The query string syntax is based on ElasticSearch's query string syntax, and can include the following search fields:

  • name
  • country
  • identifiers.identifier

Request

GET /api/funders?q=health HTTP/1.1

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "hits": {
    "hits": [
      {
        "name": "National Institutes of Health",
        "country": "US",
        "identifiers": [
          {
            "identifier": "01cwqze88",
            "scheme": "ror"
          }
        ],
        "created": "2022-06-02T14:14:49.783395+00:00",
        "id": "01cwqze88",
        "updated": "2022-06-02T14:14:49.882210+00:00",
        "revision_id": 2,
        "links": {
          "self": "{scheme+hostname}/api/funders/01cwqze88"
        },
        "title": {
          "en": "National Institutes of Health"
        }
      },
      {
        "name": "Canadian Institutes of Health Research",
        "country": "CA",
        "identifiers": [
          {
            "identifier": "01gavpb45",
            "scheme": "ror"
          }
        ],
        "created": "2022-06-02T14:14:49.704849+00:00",
        "id": "01gavpb45",
        "updated": "2022-06-02T14:14:49.790375+00:00",
        "revision_id": 2,
        "links": {
          "self": "{scheme+hostname}/api/funders/01gavpb45"
        },
        "title": {
          "en": "Canadian Institutes of Health Research"
        }
      },
      {
        "name": "National Health and Medical Research Council",
        "country": "AU",
        "identifiers": [
          {
            "identifier": "011kf5r70",
            "scheme": "ror"
          }
        ],
        "created": "2022-06-02T14:14:49.790124+00:00",
        "id": "011kf5r70",
        "updated": "2022-06-02T14:14:49.877488+00:00",
        "revision_id": 2,
        "links": {
          "self": "{scheme+hostname}/api/funders/011kf5r70"
        },
        "title": {
          "en": "National Health and Medical Research Council"
        }
      }
    ],
    "total": 3
  },
  "sortBy": "bestmatch",
  "links": {
    "self": "{scheme+hostname}/api/funders?page=1&q=health&size=25&sort=bestmatch"
  }
}

Get a funder

GET /api/funders/{id}

Parameters

Name Type Location Description
id string path The funder identifier.
accept string header - application/json

Request

GET /api/funders/{id} HTTP/1.1
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "name": "National Institutes of Health",
  "revision_id": 2,
  "identifiers": [
    {
      "scheme": "ror",
      "identifier": "01cwqze88"
    }
  ],
  "updated": "2022-06-02T14:14:49.882210+00:00",
  "country": "US",
  "created": "2022-06-02T14:14:49.783395+00:00",
  "id": "{id}",
  "links": {
    "self": "{scheme+hostname}/api/funders/{id}"
  },
  "title": {
    "en": "National Institutes of Health"
  }
}