## Get dataset by ID

`datasets.retrieve(id) -> Dataset`

**get** `/api/v1/datasets/{id}`

Get dataset by ID

### Parameters

- `id: String`

### Returns

- `class Dataset`

  - `id: String`

    Dataset ID

  - `inserted_at: Time`

    Creation timestamp

  - `name: String`

    Dataset name

  - `slug: String`

    URL-friendly slug

  - `updated_at: Time`

    Last update timestamp

  - `attribution: String`

    Attribution text

  - `description: String`

    Dataset description

  - `license: String`

    License identifier

  - `source_url: String`

    Source data URL

### Example

```ruby
require "plaza"

plaza = Plaza::Client.new(
  api_key: "My API Key",
  environment: "local" # defaults to "production"
)

dataset = plaza.datasets.retrieve("id")

puts(dataset)
```

#### Response

```json
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "inserted_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "slug": "slug",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "attribution": "attribution",
  "description": "description",
  "license": "license",
  "source_url": "source_url"
}
```