Retrieve a review for a business

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

{
  "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"
          }
        }
      ]
    }
  ]
}

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

Allowed values:

idstringformat: "uuid"

created_atdatetime

updated_atdatetime

taskslist of objects

completed_atdatetime or null

assigneeobject or null

Errors

404

Get Business Review Request Not Found Error

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

1	{
2	"object": "review",
3	"id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd",
4	"created_at": "2025-01-07T12:00:00Z",
5	"updated_at": "2025-01-07T12:00:00Z",
6	"tasks": [
7	{
8	"category": "name",
9	"key": "location_frequency",
10	"label": "Politically Exposed Persons",
11	"message": "Business name requires verification",
12	"name": "name",
13	"status": "success",
14	"sub_label": "Verify business name",
15	"sources": [
16	{
17	"id": "id",
18	"type": "type",
19	"metadata": {
20	"key": "value"
21	}
22	}
23	]
24	},
25	{
26	"category": "address",
27	"key": "address_verification",
28	"label": "Politically Exposed Persons",
29	"message": "Business address requires verification",
30	"name": "name",
31	"status": "success",
32	"sub_label": "Verify business address",
33	"sources": [
34	{
35	"id": "id",
36	"type": "type",
37	"metadata": {
38	"key": "value"
39	}
40	}
41	]
42	}
43	]
44	}