---
title: "Add party to the case (E2)"
method: POST
path: "/api/v1/cases/{caseId}/parties"
tags: ["Cases"]
---

# Add party to the case (E2)

`POST /api/v1/cases/{caseId}/parties`

## Request

- Base URL: `https://legal.nexusquantum.legal`
- URL: `https://legal.nexusquantum.legal/api/v1/cases/{caseId}/parties`
- Auth: HTTP bearer

Registers a party in the case. 0 credits. Jurisdiction inherited from the case.

## Path parameters

- `caseId` string, uuid, required

## Request body

- object
  - `name` string, required
  - `role` 'cliente' | 'contraparte' | 'testigo' | 'perito' | 'otro' | 'unknown': Spanish-language IDENTIFIERS, sent verbatim: `cliente` (client), `contraparte` (opposing party), `testigo` (witness), `perito` (expert witness), `otro` (other), `unknown`.
  - `entity_type` 'persona' | 'empresa' | 'entidad_publica' | 'otro': Spanish-language IDENTIFIERS, sent verbatim: `persona` (natural person), `empresa` (company), `entidad_publica` (public body), `otro` (other).
  - `notes` string

## Response `201`

{ party }

- object
  - `party` object

## Other responses

- `400`: VALIDATION_ERROR — empty name or invalid role/entity_type.
- `403`: Case does not belong to the API key owner.
- `404`: CASE_NOT_FOUND — case not found.

---

[API](https://skmtc.dev/nexusquantum/apis/nexus-legal-api.md) · [All operations](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/revisions/4084d8d4eb0b?raw)
