# Record the insurer's answer

Canonical page: https://docs.ovok.com/api/patient-billing/record-the-insurer-s-answer

`PUT /v1/patient-billing/claims/{claimId}/response`

Records the insurer's answer to a claim, as clinic staff got it on paper or in a remittance: a FHIR `ClaimResponse` with the outcome, each item's adjudication and the payment it announces. The patient's statement about it, a FHIR `ExplanationOfBenefit`, is derived from the claim and the answer.

**Scope:** the caller's project, with `PATIENT_BILLING_ENABLED` on.

## Behaviour

- Your access policy must grant `patient_billing_claims` `update` and let you read the patient, else **403** `PATIENT_BILLING_NOT_ALLOWED` or **404** `CLAIM_NOT_FOUND`.
- A claim has one answer: the first answers **201** with `Location: /v1/patient-billing/claims/<claimId>`, a later one replaces it with **200**, and the statement follows.
- `outcome` is `complete`, `partial`, or `error` for a rejected claim. Each item names the claim item it adjudicates by `itemSequence`, with amounts per category (`submitted`, `eligible`, `benefit`, `copay`, `deductible`); totals are summed per category.
- An unknown `itemSequence` or an amount in another currency than the claim's answers **422** `CLAIM_RESPONSE_INVALID`. A withdrawn claim answers **409** `CLAIM_CANCELLED`.

## Example

```bash
curl -X PUT 'https://api.sandbox.ovok.com/v1/patient-billing/claims/<claimId>/response' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk' \
  -H 'Content-Type: application/json' \
  -d '{ "outcome": "complete", "items": [{ "itemSequence": 1, "adjudication": [{ "category": "benefit", "amount": { "value": 15.81, "currency": "EUR" } }] }], "payment": { "paidOn": "2026-11-30", "amount": { "value": 15.81, "currency": "EUR" } } }'
```
