---
title: "List orders for a business"
method: GET
path: "/v1/businesses/{business_id}/orders"
tags: ["orders"]
---

# List orders for a business

`GET /v1/businesses/{business_id}/orders`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/businesses/{business_id}/orders`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:business_id/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `business_id` string, required

## Query parameters

- `packages` string
- `page` integer
- `per_page` integer

## Response `200`

orders found

- OrdersListOrdersResponse
  - `data` Order[], required
    - `object` string, required
    - `id` string, uuid, required
    - `status` 'created' | 'pending' | 'audited' | 'completed' | 'approved' | 'rejected', required
    - `business_id` string, uuid, required
    - `subproducts` OrderSubproductsItem[]
    - `completed_at` string, date-time, nullable
    - `monitoring` boolean
    - `product` 'identity' | 'liens' | 'adverse_media' | 'bankruptcies' | 'business_enrichment' | 'documents' | 'enhanced_screenings' | 'kyc' | 'litigations' | 'people_litigations' | 'people_bankruptcies' | 'people_tax_liens' | 'people_ucc_liens' | 'people_criminal_history' | 'tin' | 'website' | 'business_verification_qualify' | 'business_verification_verify' | 'international_business_verification' | 'tax_liens' | 'ucc_liens' | 'email_risk', required
    - `requester` OrderRequester
      - `name` string, nullable
      - `type` 'account' | 'user' | 'api_key'
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `object` string, required
  - `has_more` boolean, required
  - `total_count` integer

## Changes

- **2026-10-25** `adc98c847a77`: 1 warning
  - added the new `international_business_verification` enum value to the `data/items/product` response property for the response status `200`
- **2026-10-20** `410a449f7a40`: 1 info
  - the response property `data` became required for the status `200`
- **2026-09-17** `4c9cd4e834ba`: 1 breaking, 1 warning, 2 info
  - added `#/components/schemas/OrderRequesterType` to the `data/items/requester/type` response property `oneOf` list for the response status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
  - removed `#/components/schemas/type_:OrderRequesterType` from the `data/items/requester/type` response property `oneOf` list for the response status `200`
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `listOrders` removed and replaced with `orders_listOrders`

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:business_id/orders/get.md)

---

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