---
title: "Get advisor reviews (v2)"
method: GET
path: "/api/v1/alpha/advisor-reviews-v2/{id}"
tags: ["alpha"]
---

# Get advisor reviews (v2)

`GET /api/v1/alpha/advisor-reviews-v2/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/alpha/advisor-reviews-v2/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Get one Advisor review by its run id; the organization's newest (id "latest"; null before its first); or the review whose list is published now, whose order alpha_advisor_actions_list_v3 shows (id "published"; null before the first published list). Answers why it ran, the failed review it ran again, its state (running, published, failed, or stale: the list changed while it ran, so another review is owed), when it started and settled, its failure code, the settings and list revisions it read, the publications it read (each campaign's or site's newest measurement when it was admitted, a campaign named by its name as it stands now, null for a site or a campaign since deleted), and whether Run again is offered (alpha_advisor_reviews_run runs it again: only the newest, after it failed). While the newest review failed, Advisor's order stays the last published review's.

## Path parameters

- `id` union, required: A review's run id; "latest" for the organization's newest review; or "published" for the review whose list is published now (the order the list shows)
  - string, uuid
  - 'latest' | 'published'

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- AlphaAdvisorReviewsGetV2Response
  - `id` union, required: The id asked for, as asked
    - string, uuid
    - 'latest' | 'published'
  - `review` object, nullable, required: Null for "latest" before the organization's first review, and for "published" before its first published list
    - `id` string, uuid, required: The review's run; platform.runs.get reads it
    - `origin` 'schedule' | 'launch' | 'run_now' | 'recovery', nullable, required: Why it ran: its schedule, a Bootup's launch, a person's Run Advisor or saved priorities, or its own recovery; null for a review run before origins were kept
    - `retryOf` string, uuid, nullable, required: The failed review it ran again
    - `state` 'running' | 'published' | 'failed' | 'stale', required: running; published (the list's order is its); failed; stale (the list changed while it ran, so it published nothing and another review is owed)
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required: When it settled; null while it runs
    - `failureCode` string, nullable, required
    - `settingsRevision` integer, nullable, required
    - `baseListRevision` integer, nullable, required
    - `canRetry` boolean, required: It is the newest and failed, so alpha.advisor-reviews.run.v1 runs it again
    - `manifest` object[], nullable, required: Each subject's newest publication when the review was admitted: what it read; null for a review admitted before reviews froze one
      - `product` 'discovery' | 'experience' | 'inspector', required
      - `subjectId` string, required: The campaign's id, or the site a product without campaigns scanned
      - `subjectName` string, nullable, required: The campaign's name as it stands now; null for a subject that is no campaign (a scanned site), or a campaign since deleted or unnamed
      - `publicationId` string, required
      - `publishedAt` string, date-time, required

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

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