Terradue Srl

Terradue Srl Vocabularies API

Vocabulary and controlled terms endpoints

GitHub OpenAPI

Operations 20

GET /api/names Get names #
GET /api/names/{vocNamesId} Get names by ID #
GET /api/funders Specific vocabularies funders #
GET /api/funders/{vocFundersId} Specific vocabularies funders by ID #
GET /api/awards Specific vocabularies awards #
GET /api/awards/{vocAwardsId} Specific vocabularies awards by ID #
GET /api/vocabularies/{vocabularies-type} Search vocabularies #
GET /api/vocabularies/{vocabularies-type}/{vocabulariesId} Get a vocabulary record by ID #
GET /api/vocabularies/resourcetypes Search vocabularies resourcetypes #
GET /api/vocabularies/languages Search vocabularies languages #
GET /api/vocabularies/licenses Search vocabularies licenses #
GET /api/vocabularies/relationtypes Search vocabularies relationtypes #
GET /api/vocabularies/contributorsroles vocabularies contributorsroles #
GET /api/vocabularies/descriptiontypes vocabularies descriptiontypes #
GET /api/vocabularies/datetypes vocabularies datetypes #
GET /api/vocabularies/creatorsroles vocabularies creatorsroles #
GET /api/affiliations Specific vocabularies affiliations #
GET /api/affiliations/{vocAffiliationId} Specific vocabularies affiliations by ID #
GET /api/subjects Specific vocabularies subjects #
GET /api/subjects/{vocSubjectsId} Specific vocabularies subjects by ID #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/terradue-srl/openapi/terradue-srl-vocabularies-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/terradue-srl:terradue-srl-vocabularies-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

terradue-srl-vocabularies-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Invenio REST Vocabularies API
  description: '## **Summary**

    The following document is a reference guide for all the REST APIs that InvenioRDM exposes.

    ## **Resources**

    - 📚 Product documentation

    - 🔗 OpenAPI GitHub repository

    - 🌐 Invenio project

    - 💬 Community support'
  version: 12.0.3
  contact:
    name: InvenioRDM Documentation
    url: https://inveniordm.docs.cern.ch
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
  x-copyright: KTH Royal Institute of Technology 2025
  x-repo: https://github.com/Samk13/invenio-api-toolkit
servers:
- url: '{baseURL}'
  description: InvenioRDM instance
  variables:
    baseURL:
      default: https://inveniordm.web.cern.ch
      description: Base URL of your InvenioRDM instance
security:
- BearerAuth: []
tags:
- name: Vocabularies
  description: Vocabulary and controlled terms endpoints
paths:
  /api/names:
    get:
      summary: Get names
      tags:
      - Vocabularies
      operationId: getNames
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Search query used to filter results.
        example: lastname
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: 'Sort search results. Built-in options are "bestmatch", "name", "newest", "oldest" (default: "bestmatch" or "name").'
      - name: size
        in: query
        required: false
        schema:
          type: string
        description: 'Specify number of items in the results page (default: 10).'
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Specify the page of results.
      - name: suggest
        in: query
        required: false
        schema:
          type: string
        description: '"Search as you type" query.'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/names/{vocNamesId}:
    get:
      summary: Get names by ID
      tags:
      - Vocabularies
      operationId: getNamesById
      parameters:
      - name: vocNamesId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the name vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/funders:
    get:
      summary: Specific vocabularies funders
      tags:
      - Vocabularies
      operationId: specificVocabulariesFunders
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Search query used to filter results.
      - name: suggest
        in: query
        required: false
        schema:
          type: string
        description: '"Search as you type" query.'
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: 'Sort search results. Built-in options are "bestmatch", "name", "newest", "oldest" (default: "bestmatch" or "name").'
        example: bestmatch
      - name: size
        in: query
        required: false
        schema:
          type: string
        description: 'Specify number of items in the results page (default: 10).'
        example: '1'
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Specify the page of results.
        example: '1'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/funders/{vocFundersId}:
    get:
      summary: Specific vocabularies funders by ID
      tags:
      - Vocabularies
      operationId: specificVocabulariesFundersById
      parameters:
      - name: vocFundersId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the funder vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/awards:
    get:
      summary: Specific vocabularies awards
      tags:
      - Vocabularies
      operationId: specificVocabulariesAwards
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Search query used to filter results.
      - name: suggest
        in: query
        required: false
        schema:
          type: string
        description: '"Search as you type" query.'
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: 'Sort search results. Built-in options are "bestmatch", "name", "newest", "oldest" (default: "bestmatch" or "name").'
        example: bestmatch
      - name: size
        in: query
        required: false
        schema:
          type: string
        description: 'Specify number of items in the results page (default: 10).'
        example: '1'
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Specify the page of results.
        example: '1'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/awards/{vocAwardsId}:
    get:
      summary: Specific vocabularies awards by ID
      tags:
      - Vocabularies
      operationId: specificVocabulariesAwardsById
      parameters:
      - name: vocAwardsId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the award vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/{vocabularies-type}:
    get:
      summary: Search vocabularies
      tags:
      - Vocabularies
      operationId: searchVocabularies
      parameters:
      - name: vocabularies-type
        in: path
        required: true
        schema:
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Search query used to filter results based on ElasticSearch's query string syntax.
        example: arabic
      - name: suggest
        in: query
        required: false
        schema:
          type: string
        description: One or more words used to suggest records as the user types (i.e. auto-complete).
      - name: tags
        in: query
        required: false
        schema:
          type: string
        description: Filter results to the tag string
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: 'Sort search results. Unless overridden by a specific vocabulary, the built-in options are "bestmatch", "title", "newest", "oldest" (default: "bestmatch" or "title").'
        example: bestmatch
      - name: size
        in: query
        required: false
        schema:
          type: string
        description: 'Specify number of items in the results page (default: 10).'
        example: '1'
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Specify the page of results.
        example: '1'
      - name: ln
        in: query
        required: false
        schema:
          type: string
        description: Locale used to localize the title and description (e.g. en or en_US)
        example: en_US
      - name: accept-language
        in: query
        required: false
        schema:
          type: string
        description: Locale used to localize the title and description (e.g. en or en_US)
        example: en_US
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/{vocabularies-type}/{vocabulariesId}:
    get:
      summary: Get a vocabulary record by ID
      tags:
      - Vocabularies
      operationId: getAVocabularyRecordById
      parameters:
      - name: vocabularies-type
        in: path
        required: true
        schema:
          type: string
      - name: vocabulariesId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/resourcetypes:
    get:
      summary: Search vocabularies resourcetypes
      tags:
      - Vocabularies
      operationId: searchVocabulariesResourcetypes
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/languages:
    get:
      summary: Search vocabularies languages
      tags:
      - Vocabularies
      operationId: searchVocabulariesLanguages
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/licenses:
    get:
      summary: Search vocabularies licenses
      tags:
      - Vocabularies
      operationId: searchVocabulariesLicenses
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/relationtypes:
    get:
      summary: Search vocabularies relationtypes
      tags:
      - Vocabularies
      operationId: searchVocabulariesRelationtypes
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/contributorsroles:
    get:
      summary: vocabularies contributorsroles
      tags:
      - Vocabularies
      operationId: vocabulariesContributorsroles
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/descriptiontypes:
    get:
      summary: vocabularies descriptiontypes
      tags:
      - Vocabularies
      operationId: vocabulariesDescriptiontypes
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/datetypes:
    get:
      summary: vocabularies datetypes
      tags:
      - Vocabularies
      operationId: vocabulariesDatetypes
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/vocabularies/creatorsroles:
    get:
      summary: vocabularies creatorsroles
      tags:
      - Vocabularies
      operationId: vocabulariesCreatorsroles
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/affiliations:
    get:
      summary: Specific vocabularies affiliations
      tags:
      - Vocabularies
      operationId: specificVocabulariesAffiliations
      parameters: []
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/affiliations/{vocAffiliationId}:
    get:
      summary: Specific vocabularies affiliations by ID
      tags:
      - Vocabularies
      operationId: specificVocabulariesAffiliationsById
      parameters:
      - name: vocAffiliationId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the affiliation vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/subjects:
    get:
      summary: Specific vocabularies subjects
      tags:
      - Vocabularies
      operationId: specificVocabulariesSubjects
      parameters:
      - name: suggest
        in: query
        required: true
        schema:
          type: string
        example: '{{subject-query}}'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
  /api/subjects/{vocSubjectsId}:
    get:
      summary: Specific vocabularies subjects by ID
      tags:
      - Vocabularies
      operationId: specificVocabulariesSubjectsById
      parameters:
      - name: vocSubjectsId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the subject vocabulary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - BearerAuth: []
components:
  responses:
    Forbidden:
      description: Forbidden - Insufficient permissions
    Unauthorized:
      description: Unauthorized - Authentication required
    Success:
      description: Successful response
      content:
        application/json:
          schema:
            type: object
    InternalServerError:
      description: Internal server error - Unexpected server error
    BadRequest:
      description: Bad request - Invalid input parameters
    NotFound:
      description: Not found - Resource does not exist
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication