/datasets/{id}

GET

The dataset contains all high level information, for additional details see editions or versions of a dataset.

Parameters

Name Type Description
id path Id that represents a dataset

Responses

200: A json object for a single Dataset

Example value
{
  "description": "A model for the response body when getting a dataset",
  "allOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "description": "An unique id for a dataset",
          "type": "string",
          "readOnly": true,
          "example": "DE3BC0B6-D6C4-4E20-917E-95D7EA8C91DC"
        },
        "type": {
          "description": "The type for a dataset",
          "type": "string",
          "default": "filterable",
          "enum": [
            "filterable",
            "nomis"
          ]
        }
      }
    },
    {
      "description": "The dataset",
      "type": "object",
      "required": [
        "id",
        "contacts",
        "description",
        "license",
        "links",
        "national_statistics",
        "title"
      ],
      "properties": {
        "canonical_topic": {
          "description": "The canonical topic id for this dataset.  This indicates which topic this dataset belongs to within the website taxonomy.",
          "type": "string"
        },
        "collection_id": {
          "description": "The id of the unpublished collection (of datasets) that this dataset is associated with",
          "type": "string"
        },
        "contacts": {
          "description": "A list containing contact details of staticians for a dataset",
          "type": "array",
          "items": {
            "description": "A list of objects containing contact information for this dataset",
            "type": "object",
            "properties": {
              "email": {
                "description": "An email address to contact the statistician",
                "type": "string"
              },
              "name": {
                "description": "The name of the statistician",
                "type": "string"
              },
              "telephone": {
                "description": "Telephone number to contact the statistician",
                "type": "string"
              }
            }
          }
        },
        "description": {
          "description": "A description for a dataset",
          "type": "string"
        },
        "is_based_on": {
          "description": "Information about the population-type that the dataset is based on (census 2021 only)",
          "type": "object",
          "properties": {
            "id": {
              "description": "The population-type that the dataset is based on",
              "type": "string",
              "example": "Usual-Residents"
            },
            "type": {
              "description": "The type of the dataset",
              "type": "string",
              "example": "cantabular_table"
            }
          }
        },
        "keywords": {
          "description": "A list of keywords for a dataset",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "license": {
          "description": "The standard Government license right text for the dataset",
          "type": "string"
        },
        "links": {
          "description": "A list of links related to this resource",
          "type": "object",
          "properties": {
            "access_rights": {
              "type": "object",
              "properties": {
                "href": {
                  "description": "A url to the standard Government access right text for the dataset",
                  "type": "string"
                }
              }
            },
            "editions": {
              "type": "object",
              "properties": {
                "href": {
                  "description": "A URL to all editions for this dataset",
                  "type": "string",
                  "example": "http://localhost:8080/datasets/DE3BC0B6-D6C4-4E20-917E-95D7EA8C91DC/editions"
                }
              },
              "readOnly": true
            },
            "latest_version": {
              "description": "An object containing the latest version id and link",
              "type": "object",
              "properties": {
                "href": {
                  "description": "A link to the latest version and edition of the dataset",
                  "type": "string",
                  "example": "http://localhost:8080/datasets/DE3BC0B6-D6C4-4E20-917E-95D7EA8C91DC/editions/2017/versions/2"
                },
                "id": {
                  "description": "The unique id for the latest version of a dataset",
                  "type": "string"
                }
              },
              "readOnly": true
            },
            "self": {
              "description": "A link to this resource",
              "type": "object",
              "properties": {
                "href": {
                  "description": "A URL to this resource",
                  "type": "string"
                }
              },
              "readOnly": true
            },
            "taxonomy": {
              "description": "A link to the taxonomy of the dataset",
              "type": "object",
              "properties": {
                "href": {
                  "description": "A url to the taxonomy of the dataset",
                  "type": "string"
                }
              }
            }
          }
        },
        "methodologies": {
          "description": "A list of methodologies for a dataset",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "description": "The description of a methodology",
                "type": "string"
              },
              "href": {
                "description": "The url to a methodology",
                "type": "string"
              },
              "title": {
                "description": "The title of a methodology",
                "type": "string"
              }
            }
          }
        },
        "national_statistic": {
          "description": "The flag indicating the resource is a national statistic. These are certified as compliant with the Code of Practice for Official Statistics",
          "type": "boolean"
        },
        "next_release": {
          "description": "The next release date for a dataset",
          "type": "string"
        },
        "nomis_ref_url": {
          "description": "The NOMIS reference url for the dataset",
          "type": "string",
          "example": "https://www.nomisweb.co.uk/census/2011/ks106ew"
        },
        "publications": {
          "description": "A list of publications for a dataset",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "description": "The description of a publication",
                "type": "string"
              },
              "href": {
                "description": "The url to a publication",
                "type": "string"
              },
              "title": {
                "description": "The title of a publication",
                "type": "string"
              }
            }
          }
        },
        "publisher": {
          "description": "The publisher of the dataset",
          "type": "object",
          "properties": {
            "href": {
              "description": "A link to the publishers homepage",
              "type": "string"
            },
            "name": {
              "description": "The name of the publisher",
              "type": "string"
            },
            "type": {
              "description": "The type of publisher",
              "type": "string"
            }
          }
        },
        "qmi": {
          "description": "Object containing information on the quality and methodology index of a dataset",
          "type": "object",
          "properties": {
            "description": {
              "description": "The description of a quality and methodology index",
              "type": "string"
            },
            "href": {
              "description": "The url to a quality and methodology index",
              "type": "string"
            },
            "title": {
              "description": "The title of a quality and methodology index",
              "type": "string"
            }
          }
        },
        "related_content": {
          "description": "A list of objects containing information of content related to a dataset",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "description": "The description of the related content",
                "type": "string"
              },
              "href": {
                "description": "The url to related content",
                "type": "string"
              },
              "title": {
                "description": "The title of the related content",
                "type": "string"
              }
            }
          }
        },
        "related_datasets": {
          "description": "A list of objects containing information of datasets related to a dataset",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "href": {
                "description": "The url to a related dataset",
                "type": "string"
              },
              "title": {
                "description": "The title of a related dataset",
                "type": "string"
              }
            }
          }
        },
        "release_frequency": {
          "description": "The release frequency of a dataset",
          "type": "string"
        },
        "state": {
          "description": "The state of the resource, can only be one of the following:\n  * created\n  * completed (instances only)\n  * failed (instances only)\n  * edition-confirmed (instances and versions only)\n  * associated (not editions)\n  * published\n",
          "type": "string"
        },
        "subtopics": {
          "description": "A list of subtopic ids that the dataset relates to within the website taxonomy.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "survey": {
          "description": "The name of the survey the dataset was created from.",
          "type": "string"
        },
        "theme": {
          "description": "The theme for a dataset",
          "type": "string"
        },
        "title": {
          "description": "The title of the dataset",
          "type": "string",
          "example": "CPI"
        },
        "type": {
          "description": "The type of dataset",
          "type": "string",
          "example": "cantabular_flexible_table"
        },
        "unit_of_measure": {
          "description": "The unit of measure for the dataset observations",
          "type": "string"
        },
        "uri": {
          "description": "The uri to the location of this resource on the web",
          "type": "string"
        }
      }
    }
  ]
}

404: No dataset was found using the id provided

Example value
null

500: Failed to process the request due to an internal error

Example value
null