---
title: "Create a business"
method: POST
path: "/parties"
tags: ["businesses"]
deprecated: true
---

# Create a business

`POST /parties`

> **Deprecated.**

Create a business if it doesn't already exist, otherwise update its versioned attributes. Use POST /businesses instead

## Request body

- Business
  - `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

## Response `200`

The business has been created or updated

- 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'

## Other responses

- `400` — There was an error in the request body
- `409` — A business and its attributes already exist for that sample summary

---

[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)