Read Vocabulary Term

This example request illustrates how to get a vocabulary term. A vocabulary term is a type of gender, record, place, fact, etc. and is returned in the language requested.

JSON

Request

GET /platform/vocab/terms/123
Accept-Language: en
Accept: application/ld+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/ld+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/vocab/terms/123
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, max-age=604800
Transfer-encoding: chunked{
  "id" : "123",
  "@id" : "https://test.com/vocab/terms/123",
  "subclassOf" : "https://test.com/vocab/terms/ABC",
  "type" : "https://test.com/vocab/terms/official",
  "labels" : [ {
    "@language" : "en",
    "@value" : "carrot"
  } ],
  "descriptions" : [ {
    "@language" : "en",
    "@value" : "This is an English carrot"
  } ],
  "@context" : {
    "id" : {
      "@id" : "http://purl.org/dc/terms/identifier"
    },
    "subclassOf" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#subClassOf",
      "@type" : "@id"
    },
    "references" : {
      "@id" : "http://purl.org/dc/terms/references",
      "@type" : "@id"
    },
    "type" : {
      "@id" : "http://purl.org/dc/terms/type",
      "@type" : "@id"
    },
    "labels" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#label"
    },
    "descriptions" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#comment"
    }
  }
}

XML

Request

GET /platform/vocab/terms/123
Accept-Language: en
Accept: application/rdf+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/rdf+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/vocab/terms/123
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, max-age=604800
Transfer-encoding: chunked<?xml version='1.0' encoding='UTF-8'?>
<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:dc="http://purl.org/dc/terms/" xmlns:xml="http://www.w3.org/XML/1998/namespace">
  <Description about="https://test.com/vocab/terms/123">
    <dc:identifier>123</dc:identifier>
    <rdfs:subClassOf resource="https://test.com/vocab/terms/ABC"/>
    <dc:type resource="https://test.com/vocab/terms/official"/>
    <rdfs:label xml:lang="en">carrot</rdfs:label>
    <rdfs:comment xml:lang="en">This is an English carrot</rdfs:comment>
  </Description>
</RDF>