---
title: "Get analysis status"
method: GET
path: "/api/v1/analysis/{uuid}"
tags: ["Analysis"]
---

# Get analysis status

`GET /api/v1/analysis/{uuid}`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/analysis/{uuid}`
- Auth: HTTP bearer

Returns analysis details including status. Poll this endpoint until status is 'completed' or 'failed'.

## Path parameters

- `uuid` string, required

## Response `200`

Successful response.

- object
  - `analysis` Analysis
    - `completed_at` string, date-time, nullable
    - `credits_used` integer
    - `models` string[]
    - `recommendations` object[]: Generated recommendations; empty until POST /analysis/:uuid/recommendations succeeds.
      - `action` string
      - `priority` 'high' | 'medium' | 'low'
      - `reasoning` string
      - `target_keywords` string[]
      - `target_urls` string[]
    - `recommendations_generated_at` string, date-time, nullable
    - `response_count` integer
    - `scope` 'site' | 'customer_type' | 'persona' | 'questions'
    - `site_uuid` string
    - `started_at` string, date-time
    - `status` 'pending' | 'running' | 'completed' | 'failed'
    - `uuid` string

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

[API](https://skmtc.dev/botsee/apis/botsee-api.md) · [All operations](https://skmtc.dev/botsee/apis/botsee-api/llms.txt) · [OpenAPI document](https://skmtc.dev/botsee/apis/botsee-api/revisions/f815b844e73b?raw)