> ## 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 List Datasets

> GET /v1/datasets for the PIN API. Retrieve a list of all datasets in your account, including names, formats, statuses, and metadata.

Use the list datasets endpoint to retrieve all datasets associated with your account. The response includes each dataset's name, format, status, size, row count, access mode, and creation time.

## Endpoint

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

## Authentication

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

## Response

<ResponseField name="items" type="array">
  <Expandable title="Dataset object">
    <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>
  </Expandable>
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "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 Upload Dataset](/api-reference/pin/datasets/create.md)
- [PIN Create Dataset from Catalog](/api-reference/pin/datasets/from-catalog.md)
- [PIN Get Dataset by ID](/api-reference/pin/datasets/get.md)
- [List PIN Models](/api-reference/pin/models/list.md)