Skip to main content
POST
/
api
/
v2
/
public
/
tables
/
:table_id
/
search
curl -X POST "https://app.refold.ai/api/v2/public/tables/{table_id}/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "stage": "qualified" }'

[
  { "record_id": "166047e8-f290-416b-ab4c-0fd03119d9f6", "email": "john@example.com", "stage": "qualified" }
]
Search a persistent table by column values. The request body is a {column: value} map; matching records are returned.

​
Authentication

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

​
Path Parameters

​
table_id
string
required
The table ID.

​
Body Parameters

​
{column}
string
One or more column: value pairs to match against records.

​
Response

Returns an array of matching records.
[
  { "record_id": "166047e8-f290-416b-ab4c-0fd03119d9f6", "email": "john@example.com", "stage": "qualified" }
]

curl -X POST "https://app.refold.ai/api/v2/public/tables/{table_id}/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "stage": "qualified" }'