---
title: "Create Subject"
method: POST
path: "/v1/matters/{matter_id}/searches/subjects"
tags: ["searches"]
---

# Create Subject

`POST /v1/matters/{matter_id}/searches/subjects`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/searches/subjects`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateSearchSubject
  - `kind` 'individual' | 'organisation' | 'property' | 'asset', required
  - `label` string, required
  - `identity` SearchSubjectIdentityInput, required
    - `given_names` string, nullable
    - `family_name` string, nullable
    - `date_of_birth` string, date, nullable
    - `organisation_name` string, nullable
    - `acn` string, nullable
    - `abn` string, nullable
    - `address` string, nullable
    - `state` string, nullable
    - `postcode` string, nullable
    - `title_reference` string, nullable
    - `lot` string, nullable
    - `plan` string, nullable
    - `serial_number` string, nullable
    - `serial_number_type` string, nullable
    - `registration_number` string, nullable
    - `search_number` string, nullable
  - `source` 'manual'

## Response `201`

Successful Response

- SearchSubject
  - `kind` 'individual' | 'organisation' | 'property' | 'asset', required
  - `label` string, required
  - `identity` SearchSubjectIdentityOutput, required
    - `given_names` string, nullable, required
    - `family_name` string, nullable, required
    - `date_of_birth` string, date, nullable, required
    - `organisation_name` string, nullable, required
    - `acn` string, nullable, required
    - `abn` string, nullable, required
    - `address` string, nullable, required
    - `state` string, nullable, required
    - `postcode` string, nullable, required
    - `title_reference` string, nullable, required
    - `lot` string, nullable, required
    - `plan` string, nullable, required
    - `serial_number` string, nullable, required
    - `serial_number_type` string, nullable, required
    - `registration_number` string, nullable, required
    - `search_number` string, nullable, required
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `matter_id` string, uuid, required
  - `source` 'manual' | 'matter' | 'day_ones' | 'imported', required
  - `version` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)