Collection APIs

All the following APIs use the following domain:

https://api-production.data.gov.sg/

For example:

https://api-production.data.gov.sg/v2/public/api/collections

Collections listing

This API returns a list of all the collections on data.gov.sg

Get collections

GET/v2/public/api/collections

Query parameters

Response

200

Successful response

Body

application/json

codeinteger

dataobject

errorMsgstring

Request

JavaScriptCurl

const response = await fetch('/v2/public/api/collections', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "collections": [
      {
        "collectionId": "text",
        "createdAt": "2016-06-01T19:09:53+08:00",
        "name": "text",
        "description": "text",
        "lastUpdatedAt": "2016-06-01T19:09:53+08:00",
        "coverageStart": "2016-06-01T19:09:53+08:00",
        "coverageEnd": "2016-06-01T19:09:53+08:00",
        "frequency": "text",
        "sources": [
          "text"
        ],
        "managedByAgencyName": "text",
        "childDatasets": [
          "text"
        ]
      }
    ]
  },
  "errorMsg": "text"
}

Collection metadata

This API returns the metadata of a single collection and the datasets within it

Get metadata for a collection

GET/v2/public/api/collections/{collectionId}/metadata?withDatasetMetadata=true

Path parameters

collectionId*number

The unique identifier of the collection (number)

Query parameters

Response

200

Successful response

Body

application/json

codeinteger

dataobject

errorMsgstring

Request

JavaScriptCurl

const response = await fetch('/v2/public/api/collections/{collectionId}/metadata?withDatasetMetadata=true', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "collectionMetadata": {
      "collectionId": "text",
      "createdAt": "2015-05-20T10:11:24+08:00",
      "name": "text",
      "description": "text",
      "lastUpdatedAt": "2020-06-26T12:19:29+08:00",
      "coverageStart": "2015-05-20T10:11:24+08:00",
      "coverageEnd": "2020-06-26T12:19:29+08:00",
      "frequency": "text",
      "sources": [
        "text"
      ],
      "managedBy": "text",
      "childDatasets": [
        "text"
      ]
    },
    "datasetMetadata": [
      {
        "datasetId": "text",
        "createdAt": "2015-05-21T14:10:45+08:00",
        "name": "text",
        "format": "text",
        "lastUpdatedAt": "2020-06-26T12:18:21+08:00",
        "managedBy": "text",
        "coverageStart": "2015-05-20T10:11:24+08:00",
        "coverageEnd": "2020-06-26T12:19:29+08:00"
      }
    ]
  },
  "errorMsg": "text"
}

To find the collectionId, refer to the URL of collection. For this collection: https://beta.data.gov.sg/collections/522/view The collectionId is: 522