---
title: "Search for businesses"
method: GET
path: "/businesses/search"
tags: ["businesses"]
---

# Search for businesses

`GET /businesses/search`

Search for businesses

## Query parameters

- `query` string, required
- `page` integer, required
- `limit` integer, required
- `max_rec` integer, required

## Response `200`

The businesses have been retrieved

- object
  - `businesses` BusinessResponse[]
    - `id` string, uuid
    - `sampleUnitRef` string, string
    - `sampleUnitType` 'B' | 'BI'
    - `sampleSummaryId` string, uuid
    - `attributes` BusinessAttributes
      - `ruref` string
      - `birthdate` string, date
      - `checkletter` string
      - `currency` string
      - `entname1` string
      - `entname2` string
      - `entname3` string
      - `entref` string
      - `entremkr` string
      - `formtype` string
      - `froempment` integer
      - `frosic2007` string
      - `frosic92` string
      - `frotover` integer
      - `inclexcl` string
      - `legalstatus` string
      - `region` string
      - `runame1` string
      - `runame2` string
      - `runame3` string
      - `rusic2007` string
      - `rusic92` string
      - `seltype` string
      - `tradstyle1` string
      - `cell_no` number
    - `name` string
    - `trading_as` string
    - `associations` Association[]
      - `partyId` string, uuid
      - `sampleUnitRef` string, string
      - `businessRespondentStatus` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
      - `enrolments` Enrolment[]
        - `surveyId` string, uuid
        - `enrolmentStatus` 'PENDING' | 'ENABLED' | 'DISABLED' | 'SUSPENDED'
  - `total_business_count` integer

## Other responses

- `400` — The request was missing one or more of the query parameters

---

[API](https://skmtc.net/office-of-national-statistics/apis/party-service-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/party-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/party-service-api/revisions/a9abfd072409/schema)