> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Datarefs

> List datarefs for the org or a linked account.

List datarefs (named reference-data stores) for your org and environment, paginated. Optionally filter to a single linked account or to unique names.

## Authentication

<ParamField header="x-api-key" type="string" required>Your Refold API key.</ParamField>

## Query Parameters

<ParamField query="linked_account_id" type="string">Filter to a single linked account's datarefs.</ParamField>
<ParamField query="unique" type="boolean">Return unique dataref names with their linked accounts.</ParamField>
<ParamField query="page" type="integer" default="1">Page number.</ParamField>
<ParamField query="limit" type="integer" default="10">Page size.</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    Returns a paginated envelope.

    <ResponseField name="docs" type="array">
      Dataref objects.

      <Expandable title="properties">
        <ResponseField name="_id" type="string">Record ID.</ResponseField>
        <ResponseField name="name" type="string">Dataref name (`refName`).</ResponseField>
        <ResponseField name="linked_account_id" type="string">Owning linked account.</ResponseField>
        <ResponseField name="environment" type="string">`test` or `live`.</ResponseField>
        <ResponseField name="createdAt" type="string">ISO 8601 timestamp.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="totalDocs" type="integer">Total datarefs.</ResponseField>
    <ResponseField name="page" type="integer">Current page.</ResponseField>
    <ResponseField name="limit" type="integer">Page size.</ResponseField>
    <ResponseField name="totalPages" type="integer">Total pages.</ResponseField>
    <ResponseField name="hasNextPage" type="boolean">Whether another page follows.</ResponseField>
  </Tab>

  <Tab title="401 Unauthorized">
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 theme={null}
  {
    "docs": [
      {
        "_id": "6a3149efd396207fd24f7aad",
        "linked_account_id": "user_12345",
        "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
        "environment": "test",
        "name": "contacts",
        "createdAt": "2026-06-16T13:04:47.926Z",
        "updatedAt": "2026-06-16T13:04:47.926Z",
        "__v": 0
      }
    ],
    "totalDocs": 1,
    "limit": 10,
    "page": 1,
    "totalPages": 1,
    "hasNextPage": false
  }
  ```

  ```json 401 theme={null}
  {
    "status_code": 401,
    "http_error_type": "UNAUTHORIZED",
    "error": "SERVER_ERROR",
    "message": "Invalid Credentials"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/dataref?linked_account_id=YOUR_LINKED_ACCOUNT_ID" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>