cURL
curl --request GET \
--url https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}', 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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}",
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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}"
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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}")
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{
"blocks": {},
"content": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"embed": "<string>",
"index_status": "<string>",
"kb_file_id": "<string>",
"ordinal": "<string>",
"revision": "<string>",
"source": "<string>",
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_at": "2023-11-07T05:31:56Z",
"index_error": "<string>",
"indexed_at": "2023-11-07T05:31:56Z",
"page_end": 123,
"page_start": 123
}{
"code": "<string>",
"message": "<string>"
}Chunks
Get Chunk
Get a single chunk by uid.
GET
/
orgs
/
{org_id}
/
k2
/
{kb_id}
/
files
/
{file_id}
/
chunks
/
{chunk_uid}
cURL
curl --request GET \
--url https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}', 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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}",
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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}"
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.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.timbal.ai/orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}")
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{
"blocks": {},
"content": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"embed": "<string>",
"index_status": "<string>",
"kb_file_id": "<string>",
"ordinal": "<string>",
"revision": "<string>",
"source": "<string>",
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_at": "2023-11-07T05:31:56Z",
"index_error": "<string>",
"indexed_at": "2023-11-07T05:31:56Z",
"page_end": 123,
"page_start": 123
}{
"code": "<string>",
"message": "<string>"
}Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Path Parameters
Response
Chunk
Source-document layout metadata (e.g. bounding boxes, page coords)
when available. null for chunks created or edited by the user.
Indexing state for search (pending, indexing, indexed, or failed).
Ordering key within the file.
Revision token for optimistic concurrency on update and delete.
Origin of the chunk: parser, user_edit, or insert.
Stable per-chunk identity.