---
title: "Analyze Pillar"
method: POST
path: "/api/v1/tbpi/analyze"
tags: ["TBPI Analysis"]
---

# Analyze Pillar

`POST /api/v1/tbpi/analyze`

## Request

- Base URL: `https://app.perlucem.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.perlucem.ai/api/v1/tbpi/analyze`
- Auth: HTTP bearer

Initiate TBPI analysis for a specific pillar

This endpoint starts an asynchronous analysis process. The analysis
runs in the background and can take 60-90 seconds to complete.

**Process:**
1. Validates RSSD ID and pillar
2. Creates analysis session
3. Launches background analysis task
4. Returns session ID for progress tracking

**Usage:**
```
POST /api/v1/tbpi/analyze
{
    "rssd_id": "59754",
    "pillar": "revenue"
}
```

Poll `/progress/{session_id}` to track progress.

## Request body

- AppApiV1EndpointsTbpiAnalyzeRequest: Request body for initiating TBPI analysis
  - `rssd_id` string, required: Bank RSSD ID
  - `pillar` string, required: Pillar to analyze
  - `start_period` string, nullable: Start period (e.g., '12/31/2024')
  - `end_period` string, nullable: End period (e.g., '9/30/2025')

## Response `202`

Successful Response

- AnalyzeResponse: Response for initiated analysis
  - `session_id` string, required
  - `rssd_id` string, required
  - `pillar` string, required
  - `status` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/perlucem/apis/perlucem-ai-backend.md) · [All operations](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/revisions/e1830fb27394?raw)