curl -G "https://backend.botcadence.com/organizations/ORG_ID/projects" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode "skip=0" \
--data-urlencode "limit=20" \
--data-urlencode 'filters={"status":"active"}'
const params = new URLSearchParams({
skip: "0",
limit: "20",
filters: JSON.stringify({ status: "active" }),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/projects",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"skip": 0,
"limit": 20,
"filters": json.dumps({"status": "active"}),
},
)
{
"status": "success",
"message": "Projects retrieved successfully",
"data": {
"items": [
{
"_id": "665f1a2b3c4d5e6f7a8b9c0d",
"name": "Support Hub",
"status": "active",
"language": "English",
"timezone": "UTC"
}
],
"pagination": {
"total": 3,
"page": 1,
"page_size": 20,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
},
"status_code": 200
}
Projects
List projects
List projects in an organization with pagination
GET
/
organizations
/
{organization_id}
/
projects
curl -G "https://backend.botcadence.com/organizations/ORG_ID/projects" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode "skip=0" \
--data-urlencode "limit=20" \
--data-urlencode 'filters={"status":"active"}'
const params = new URLSearchParams({
skip: "0",
limit: "20",
filters: JSON.stringify({ status: "active" }),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/projects",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"skip": 0,
"limit": 20,
"filters": json.dumps({"status": "active"}),
},
)
{
"status": "success",
"message": "Projects retrieved successfully",
"data": {
"items": [
{
"_id": "665f1a2b3c4d5e6f7a8b9c0d",
"name": "Support Hub",
"status": "active",
"language": "English",
"timezone": "UTC"
}
],
"pagination": {
"total": 3,
"page": 1,
"page_size": 20,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
},
"status_code": 200
}
Returns a paginated list of projects for the organization.
Authentication
string
required
Project API key for this organization. Format:
bot_live_…Path parameters
string
required
Organization ID. Must match the API key.
Query parameters
integer
default:"0"
Number of records to skip.
integer
default:"20"
Page size. Range:
1–100.string
JSON filter object, for example
{"status":"active"}.string
JSON sort object, for example
{"created_at":-1}.string
JSON projection object, for example
{"name":1,"status":1}.Response
array
required
Project objects for the current page.
object
required
Pagination metadata.
Errors
Unauthorized
Missing, invalid, or revoked API key.
Forbidden
API key is not authorized for this organization.
curl -G "https://backend.botcadence.com/organizations/ORG_ID/projects" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode "skip=0" \
--data-urlencode "limit=20" \
--data-urlencode 'filters={"status":"active"}'
const params = new URLSearchParams({
skip: "0",
limit: "20",
filters: JSON.stringify({ status: "active" }),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/projects?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/projects",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"skip": 0,
"limit": 20,
"filters": json.dumps({"status": "active"}),
},
)
{
"status": "success",
"message": "Projects retrieved successfully",
"data": {
"items": [
{
"_id": "665f1a2b3c4d5e6f7a8b9c0d",
"name": "Support Hub",
"status": "active",
"language": "English",
"timezone": "UTC"
}
],
"pagination": {
"total": 3,
"page": 1,
"page_size": 20,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
},
"status_code": 200
}

