curl --request GET \
--url https://api.quiva.ai/records \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.quiva.ai/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.quiva.ai/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.quiva.ai/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.quiva.ai/records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.quiva.ai/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.quiva.ai/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 123,
"body": {
"results": [
{
"id": "<string>",
"config_id": "<string>",
"data": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"results_total": 123,
"total_hits": 123,
"next_cursor": "<string>"
}
}{
"status_code": 400,
"body": {
"error": "field 'rating' is required"
}
}{
"status_code": 400,
"body": {
"error": "field 'rating' is required"
}
}Query records
Search for records across a folder or space (index-backed). At least one of folder or space_id must be provided, and a Bearer JWT is required (used to derive the tenant) — an API key alone is rejected on this endpoint. folder/space_id conditions are ANDed. Results are sorted by created_at.
curl --request GET \
--url https://api.quiva.ai/records \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.quiva.ai/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.quiva.ai/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.quiva.ai/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.quiva.ai/records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.quiva.ai/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.quiva.ai/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 123,
"body": {
"results": [
{
"id": "<string>",
"config_id": "<string>",
"data": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"results_total": 123,
"total_hits": 123,
"next_cursor": "<string>"
}
}{
"status_code": 400,
"body": {
"error": "field 'rating' is required"
}
}{
"status_code": 400,
"body": {
"error": "field 'rating' is required"
}
}Authorizations
Query Parameters
next_cursor from the previous page, passed back unchanged with the same filter and sort_by. Replaces offset: sending both is refused 400, as is a cursor with latest_by. Pages of any depth; rows with equal sort values are neither skipped nor repeated. The sort field must be a declared sortable index field. Answers 501 while the indexer predates cursor paging.
true on the first page of a cursor walk: the reply then carries next_cursor and no next_offset. Cursor pages order by the index's sort keys; without it the page is ordered and paged exactly as before. Refused 400 with latest_by; answers 501 while the indexer predates cursor paging.
Records in this folder or anywhere below it, at any depth: a folder, or a dotted folder path (read by its last parent.child pair). One indexed term, ANDed with every other parameter. Echoed as under_folder in the reply. Answers 503 until the account's records are indexed with their folder ancestors. Satisfies the scope requirement on its own.
JSON {"group_field":"...","order_field":"..."}: keep the row with the highest order_field per group_field value. order_field must be a declared sortable index field. Reads one page of at most 1000 scoped rows, highest order_field first (the index page maximum; no sortable record field is unique, so deeper paging is not used); the reply carries truncated: true when more matched. total_hits counts groups.