> For the complete documentation index, see [llms.txt](https://dev.ishare.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.ishare.eu/participant-registry-role/claims-post.md).

# Claims \[POST]

The `POST` request to the `/parties/{partyId}/claims` endpoint can be used to create a new claim for a party in the Participant Registry.

{% hint style="info" %}
The `POST` request to the `/parties/{partyId}/claims` is an **OPTIONAL** endpoint.
{% endhint %}

### Request model

The following URL parameter must be used.

* `partyId` {url}/parties/{**partyId**} <mark style="color:red;">(Required)</mark>\
  **String**. The id of the party for who a new claim must be registered. Can be anyone of the party id from id or alsoKnownAs attributes of that participant. Since all participants are automatically allocated the derived ishare did, that id is always an option to search for a participant.

The request must be passed as JWT. The JSON body must contain a claim. Refer to [Claim models](/reference/claim-models.md) for an overview of available claims.

In the `POST` request the `id` and `registrarId` fields may be omitted, as they will be provided by the Participant Registry.

### Example request

```json
POST /parties/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json

{
  "id": "5ffb4bb9-2020-4045-a922-3bd84e78f709",
  "registrarId": " did:ishare:NTRNL-10000000",
  "type": "frameworkCompliance",
  "frameworkId": "iSHARE",
  "status": "active",
  "startDate": "2025-01-01T00:00:00.000Z",
  "endDate": "2026-12-31T00:00:00.000Z",
  "additionalInfo": {
    "description": "Example description",
    "publiclyPublishable": true,
    "website": "https://www.example.com"
  }
}
```

### Response model

The response will be equal to the response of the [GET request for retrieving a single claim](/participant-registry-role/claims-single-claim-get.md). Refer to the response model as defined here.

### Example response

Refer to the example response under the [GET request](/participant-registry-role/claims-single-claim-get.md) definition.