Records (Metadata)

Method: GET
Availability: Available since version 1
History: Query parameters and response formats significantly changed in version 3. Versions 1 and 2 are no longer supported.

The Get Metadata API call returns the available metadata for a specific item.

URL format

http://api.digitalnz.org/<version>/records/<record_id>.<response_format>?<request-parameters>

Required request parameters

The following must be specified as request parameters:

  • api_key - the developer API key. In the example URLs replace <your_api_key> with your personal API key Example:
    http://api.digitalnz.org/v3/records/37757055.json?api_key=<your_api_key>

Request Parameters, Optional

The following may be specified as request parameters:

  • fields - comma-separated list of fields, or groups of fields, to be returned. Possible groups include 'default' and 'verbose'. If no value is specified, then the 'default' field group will be returned.
    http://api.digitalnz.org/v3/records/37757055.json?api_key=your_api_key &fields=title,description,creator,collection_title

Record ID

Record IDs are returned in the "id" field of results from the Search Records API call. 37757055 is an example record ID.

Response format

The v3 API returns Get Metadata XML, JSON and RSS in the same format as Search Results.