Retrieve a review for a business

{
  "object": "review",
  "id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd",
  "created_at": "2025-01-07T12:00:00Z",
  "updated_at": "2025-01-07T12:00:00Z",
  "tasks": [
    {
      "category": "name",
      "key": "location_frequency",
      "label": "Politically Exposed Persons",
      "message": "Business name requires verification",
      "name": "name",
      "status": "success",
      "sub_label": "Verify business name",
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ]
    },
    {
      "category": "address",
      "key": "address_verification",
      "label": "Politically Exposed Persons",
      "message": "Business address requires verification",
      "name": "name",
      "status": "success",
      "sub_label": "Verify business address",
      "sources": [
        {
          "id": "id",
          "type": "type",
          "metadata": {
            "key": "value"
          }
        }
      ]
    }
  ],
  "analyst_read_markdown": "analyst_read_markdown",
  "analyst_read_generated_at": "2024-01-15T09:30:00Z"
}

Returns the review associated with a business

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

business_idstringRequired

Business ID

Response

review found

objectenum

idstringformat: "uuid"

created_atdatetime

updated_atdatetime

taskslist of objects

completed_atdatetime or nullOptional

analyst_read_markdownstring or nullOptional

LLM-generated analyst read of the business’s verification results, in CommonMark markdown: one lead sentence followed by up to five bullet findings. Inline links, when present, are dashboard-relative paths (for example /businesses/{id}/registrations) and may be ignored by API consumers. Null until a read has been generated; generated only for businesses without a risk order, whose risk assessment carries its own read.

analyst_read_generated_atdatetime or nullOptional

When the analyst read was delivered. Null until a read has been generated.

assigneeobject or nullOptional

Errors

404

Get Business Review Request Not Found Error

$	curl https://api.middesk.com/v1/businesses/business_id/review \
>	-H "Authorization: Bearer <token>"