Get Project

Retrieve the full detail record for a single recording project.

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

Get a project's full configuration plus recording and virtual number counts.

Requires read permission

API Key Scope

Scope	Behavior
Account-wide	Can fetch any project in the account.
Project-scoped	Can only fetch its own project. Other IDs return `404`.

Path Parameters

Parameters

Name	Type	Required	Default	Description
`id`	integer	Yes	-	Numeric project ID.

Request

cURL


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

Python


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

Node.js


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

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-15T11:32:00Z",
  "description": "Inbound English-language support line.",
  "goal_language": "en",
  "summary_language": "en",
  "long_pause_threshold_seconds": 5,
  "transcription_hints": "IdentityCall, KYC, SCA",
  "retention_days": 365,
  "quality_baseline_enabled": true,
  "quality_baseline_pct": 75.0,
  "recordings_count": 1284,
  "virtual_numbers_count": 3
}
}

Response Fields

Field	Type	Description
`id`	integer	Numeric project ID.
`name`	string	Display name.
`language`	string \| null	Default ISO language code.
`industry`	string \| null	Industry tag.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-modified timestamp.
`description`	string \| null	Free-form description.
`goal_language`	string \| null	Language used for goal-evaluation prompts.
`summary_language`	string \| null	Language used to render summaries.
`long_pause_threshold_seconds`	integer \| null	Threshold for long-pause detection.
`transcription_hints`	string \| null	Domain vocabulary biases.
`retention_days`	integer \| null	Days before auto-deletion. `null` disables retention.
`quality_baseline_enabled`	boolean	Whether quality baselining is on.
`quality_baseline_pct`	number \| null	Target percentile for the quality baseline.
`recordings_count`	integer	Number of recordings in this project.
`virtual_numbers_count`	integer	Number of virtual numbers attached to this project.

Errors

Status	Condition
401	Missing or invalid `Authorization` header.
403	API key lacks `read` permission.
404	Project does not exist, or a project-scoped key requested an `id` other than its own.

Try It

API Key

Parameters

id*

Get Project

API Key Scope

Path Parameters

Parameters

Request

cURL

Python

Node.js

Response

Response Fields

Errors

Try It

Try It

See also