Skip to main content
GET
/
api
/
v2
/
public
/
dataref
/
:refName
curl -X GET "https://app.refold.ai/api/v2/public/dataref/{refName}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

{
  "headers": ["record_id", "email", "stage"],
  "rows": [
    { "record_id": "1", "email": "jane@example.com", "stage": "qualified" }
  ],
  "page": 1,
  "limit": 100,
  "totalDocs": 1,
  "totalPages": 1,
  "hasNextPage": false
}
Return a dataref’s records reshaped as a tabular structure — headers plus rows — paginated by record ID.

​
Authentication

​
x-api-key
string
required
Your Refold API key.
​
linked_account_id
string
required
The linked account that owns the dataref.

​
Path Parameters

​
refName
string
required
The dataref name. Example: contacts

​
Query Parameters

​
page
integer
default:"1"
Page number.
​
limit
integer
default:"100"
Rows per page.

​
Response

​
headers
array
Column names. Always includes record_id.
​
rows
array
Row objects keyed by header.
​
totalDocs
integer
Total rows.
​
page
integer
Current page.
​
limit
integer
Rows per page.
​
hasNextPage
boolean
Whether another page follows.
{
  "headers": ["record_id", "email", "stage"],
  "rows": [
    { "record_id": "1", "email": "jane@example.com", "stage": "qualified" }
  ],
  "page": 1,
  "limit": 100,
  "totalDocs": 1,
  "totalPages": 1,
  "hasNextPage": false
}

curl -X GET "https://app.refold.ai/api/v2/public/dataref/{refName}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"