List documents

curl --request GET \
  --url https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents', 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.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents",
  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.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents")

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

{
  "items": [
    {
      "id": "9c1f8a7e-0b3a-4d11-9b9c-2c4f8a7e0b3a",
      "createdAt": "2026-05-10T14:32:11Z",
      "name": "product-launch-deck.pdf"
    }
  ],
  "hasMore": true
}

AI SDR Knowledge Bases

List documents

Requires the ai-sdr:read scope (or a broader one that includes it).

Use this endpoint when you need to see which files a knowledge base holds for the AI SDR agent to draw on. Results are returned as a page controlled by the top and skip query parameters; omit both to get the first page. Pass search to keep only the documents whose name contains the given text. Each item carries the document id, its file name and when it was added. The AI SDR feature must be enabled for your team.

GET

ai-sdr

knowledge-bases

{knowledge_base_id}

documents

List documents

curl --request GET \
  --url https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents', 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.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents",
  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.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/documents")

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

{
  "items": [
    {
      "id": "9c1f8a7e-0b3a-4d11-9b9c-2c4f8a7e0b3a",
      "createdAt": "2026-05-10T14:32:11Z",
      "name": "product-launch-deck.pdf"
    }
  ],
  "hasMore": true
}

Authorizations

Authorization

string

header

required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

knowledge_base_id

integer<int64>

required

Parent knowledge base id

Required range: x >= 1

Query Parameters

top

integer

Maximum number of items to return (default 100, max 1000)

skip

integer

Number of items to skip

string

Case-insensitive substring match on document name

Response

Paginated list of documents

items

KnowledgeBaseDocument · object[]

Show child attributes

hasMore

boolean

Getting started

For AI agents

API Documentation

Schemas

Webhooks

Machine-readable

List documents

Authorizations

Path Parameters

Query Parameters

Response