List Projects

Retrieve all recording projects accessible to the current API key.

GEThttps://api.identitycall.ai/api/v1/public/projects

Returns the projects this API key can access, ordered by name.

Requires read permission

API Key Scope

Scope	Behavior
Account-wide	Returns every project in the account.
Project-scoped	Returns only the single project the key is bound to.

Query Parameters

This endpoint takes no query parameters. Only the standard Authorization: Bearer header is required.

Request

cURL


curl -X GET "https://api.identitycall.ai/api/v1/public/projects" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
 
response = requests.get(
    "https://api.identitycall.ai/api/v1/public/projects",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
 
projects = response.json()["data"]
for project in projects:
    print(f"{project['id']}: {project['name']} ({project['language']})")

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
 
const response = await fetch(
  'https://api.identitycall.ai/api/v1/public/projects',
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
 
const { data: projects } = await response.json();
projects.forEach(project => {
  console.log(`${project.id}: ${project.name} (${project.language})`);
});

Response

Response200 OK

{
"data": [
  {
    "id": 42,
    "name": "Customer Support EN",
    "language": "en",
    "industry": "ecommerce",
    "created_at": "2026-04-15T10:00:00Z",
    "updated_at": "2026-04-15T10:00:00Z"
  },
  {
    "id": 43,
    "name": "Sales Outbound",
    "language": "en",
    "industry": "insurance",
    "created_at": "2026-04-12T09:15:00Z",
    "updated_at": "2026-04-14T17:42:00Z"
  },
  {
    "id": 44,
    "name": "Compliance Recordings",
    "language": "lt",
    "industry": null,
    "created_at": "2026-03-28T08:00:00Z",
    "updated_at": "2026-03-28T08:00:00Z"
  }
]
}

Response Fields

Each item in data is the short Project form:

Field	Type	Description
`id`	integer	Numeric project ID. Use this in path params for other project endpoints.
`name`	string	Display name of the project.
`language`	string \| null	Default ISO language code (e.g. `en`, `lt`, `de`).
`industry`	string \| null	Industry tag set on the project.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-modified timestamp.

For the full project record (description, retention, baseline settings, recording counts), call Get Project.

Errors

Status	Condition
401	Missing or invalid `Authorization` header.
403	API key lacks `read` permission.

Try It

API Key

List Projects

API Key Scope

Query Parameters

Request

cURL

Python

Node.js

Response

Response Fields

Errors

Try It

Try It

See also