> ## 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 Get Dataset by ID

> GET /v1/datasets/{id} for the PIN API. Retrieve a single dataset's details including format, status, size, rows, access mode, and creation time.

Use the get dataset endpoint to retrieve detailed information about a specific dataset. Provide the dataset identifier in the path.

## Endpoint

```http theme={null}
GET /v1/datasets/{id}
```

## Authentication

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

## Path Parameters

<ParamField path="id" type="string" required>
  Unique identifier of the dataset.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique dataset identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Dataset name.
</ResponseField>

<ResponseField name="format" type="string">
  File format, such as `jsonl`, `csv`, or `parquet`.
</ResponseField>

<ResponseField name="status" type="string">
  Current status, such as `ready`, `processing`, or `downloading`.
</ResponseField>

<ResponseField name="size_bytes" type="integer">
  Size of the dataset in bytes.
</ResponseField>

<ResponseField name="rows" type="integer">
  Number of rows in the dataset.
</ResponseField>

<ResponseField name="access_mode" type="string">
  Access mode, either `local` or `stream`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the dataset was created.
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "id": "ds_123",
      "name": "my-dataset",
      "format": "jsonl",
      "status": "ready",
      "size_bytes": 10485760,
      "rows": 50000,
      "access_mode": "local",
      "created_at": "2024-06-10T14:22:00Z"
    },
    "message": ""
  }
  ```
</ResponseExample>


## Related topics

- [PIN Dataset Catalog](/api-reference/pin/datasets/catalog.md)
- [PIN List Datasets](/api-reference/pin/datasets/list.md)
- [PIN Create Dataset from Catalog](/api-reference/pin/datasets/from-catalog.md)
- [PIN Upload Dataset](/api-reference/pin/datasets/create.md)
- [Get PIN Model](/api-reference/pin/models/get.md)