---
title: "Analyze Peer Group"
method: POST
path: "/api/v1/peer/analyze"
tags: ["Peer Analysis"]
---

# Analyze Peer Group

`POST /api/v1/peer/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/peer/analyze`
- Auth: HTTP bearer

Initiate full peer analysis (background task).

Returns analysis_id for progress tracking. The analysis runs in a
background thread and can be polled via /progress/{analysis_id}.

## Request body

- AppApiV1EndpointsPeerAnalyzeRequest: Request body for initiating peer analysis.
  - `subject_rssd_id` integer, required: Subject bank RSSD ID
  - `method` string, required: Peer group method: ffiec, parametric, or custom
  - `peer_group_code` integer, nullable
  - `states` string[], nullable
  - `asset_min` number, nullable
  - `asset_max` number, nullable
  - `institution_type` string, nullable
  - `metro` boolean, nullable
  - `rssd_ids` integer[], nullable
  - `quarters` string[], required: Quarters to analyze (YYYY-MM-DD)

## Response `202`

Successful Response

- unknown

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