> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIN Dataset Catalog

> GET /v1/dataset-catalog for the PIN API. Retrieve the curated list of available datasets with metadata and catalog notes.

Use the dataset catalog endpoint to browse the curated list of datasets available for training. The response includes dataset items and additional catalog notes to help you choose the right data.

## Endpoint

```http theme={null}
GET /v1/dataset-catalog
```

## Authentication

Requires a valid `Authorization: Bearer <jwt-or-api-key>` header.

## Response

<ResponseField name="items" type="array">
  List of curated datasets available in the catalog.
</ResponseField>

<ResponseField name="notes" type="object">
  Additional metadata and notes about the catalog entries.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/dataset-catalog \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "ds_catalog_1",
          "name": "General Instruction Tuning",
          "description": "A diverse instruction-following dataset."
        }
      ],
      "notes": {
        "last_updated": "2024-06-01",
        "source": "curated"
      }
    },
    "message": ""
  }
  ```
</ResponseExample>

Use the dataset catalog endpoint to browse the curated list of datasets available for training. The response includes dataset items and additional catalog notes to help you choose the right data.

## Endpoint

```http theme={null}
GET /v1/dataset-catalog
```

## Authentication

Requires a valid `Authorization: Bearer <jwt-or-api-key>` header.

## Response

<ResponseField name="items" type="array">
  List of curated datasets available in the catalog.
</ResponseField>

<ResponseField name="notes" type="object">
  Additional metadata and notes about the catalog entries.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/dataset-catalog \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "ds_catalog_1",
          "name": "General Instruction Tuning",
          "description": "A diverse instruction-following dataset."
        }
      ],
      "notes": {
        "last_updated": "2024-06-01",
        "source": "curated"
      }
    },
    "message": ""
  }
  ```
</ResponseExample>


## Related topics

- [PIN Create Dataset from Catalog](/api-reference/pin/datasets/from-catalog.md)
- [PIN List Datasets](/api-reference/pin/datasets/list.md)
- [PIN Upload Dataset](/api-reference/pin/datasets/create.md)
- [PIN Get Dataset by ID](/api-reference/pin/datasets/get.md)
- [Create Training Job with PIN API](/api-reference/pin/jobs/create.md)