---
title: "Get Dataset by id"
method: GET
path: "/datainsights/v1.1/datasets/{dataset_id}"
tags: ["Datasets"]
---

# Get Dataset by id

`GET /datainsights/v1.1/datasets/{dataset_id}`

Obtain all the CDF information related with each Dataset and the last time the dataset has been refreshed
If categories is true, CDFs will be grouped by category

**CDF**: Cloudbeds Data field.

| Dataset                   | Dataset Id  | Description                                                                                                                                                                                       |
| ------                    | ------      | ----------                                                                                                                                                                                        |
| Financial                 | 1           | Financial transactions that are made, including debits and credit and their attributes                                                                                                            |
| Guest                     | 2           | The details on each guest at the hotel, including the history if their stays, their contact information, document information, etc                                                                |
| Reservations              | 3           | Booking or Reservation information include who booked, where the booking came from, when it occurs, the price, the rate plans, room types, etc                                                    |
| Occupancy                 | 4           | The productivity information for the hotel, including metrics such as occupancy, room nights, Revpar, ADR, etc.  Used by revenue managers to set prices and distribution strategies               |
| Payments                  | 5           | Payment processing information, including charges, fees, chargebacks, reversals, etc.
| Invoices                  | 6           | Invoices information, including reservation level information etc and credit notes.
| Occupancy (Beta)          | 7           | The productivity information for the hotel, including metrics such as occupancy, room nights, Revpar, ADR, etc.  Used by revenue managers to set prices and distribution strategies               |
| Housekeeping              | 8           | ...               |

## Path parameters

- `dataset_id` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9, required

## Query parameters

- `cdfs` 'report' | 'stock_report'

## Headers

- `X-PROPERTY-ID` integer, required

## Response `200`

OK

- DatasetById
  - `id` integer, required — Dataset id
  - `name` string — Dataset Name
  - `read_only` boolean — Flag to indicate if reports can be saved in this dataset
  - `cdfs` CDFS[] — Dataset list of CDFs grouped by Category
    - `category` string — Category of the CDF
    - `cdfs` CDF[] — List of CDFs
      - `column` string — Column name reference for description
      - `name` string — Name of the CDF
      - `description` string — Description of the CDF
      - `kind` 'String' | 'Number' | 'Dynamic' — CDF kind

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)