---
title: "POST call to create a claim record, or return existing one if already created"
method: POST
path: "/v1/claim"
tags: ["claim"]
---

# POST call to create a claim record, or return existing one if already created

`POST /v1/claim`

* Mandatory fields for Update claim - Claimant Id, Benefit type.
e.g.
  ```
  {
    "claimant_id": "5efbb7aebb703c618c3d4fe5",
    "benefit_type": "PIP"
  }
  ```

## Request body

- ClaimCreateObject — claimant id (account reference)
  - `claimant_id` string, required
  - `benefit_type` 'PIP', required — the type of benefit PIP, ESA etc..

## Response `200`

FOUND - an existing claim returned

- ClaimRecordReturn — submission id
  - `claim_id` string
  - `submission_id` string
  - `form_data` string — the session data blob
  - `claim_status` 'CLAIM_STARTED' | 'APPLICATION_SUBMITTED' — the status of the claim record

## Other responses

- `201` — CREATED - no claim with given claimant id found, new claim created and returned
- `400` — BAD REQUEST - badly formed json or invalid PIP form data
- `500` — INTERNAL SERVER ERROR - an internal error occurred

---

[API](https://skmtc.net/department-for-work-and-pensions/apis/dwp-htds-claim-manager-service.md) · [All operations](https://skmtc.net/department-for-work-and-pensions/apis/dwp-htds-claim-manager-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/department-for-work-and-pensions/dwp-htds-claim-manager-service/revisions/f2da60e4e7aa/schema)