---
title: "Receive an OptumRx NRT medical accumulator acknowledgement"
method: POST
path: "/api/v1/optumrx/medical_ack"
tags: ["OptumRx NRT"]
---

# Receive an OptumRx NRT medical accumulator acknowledgement

`POST /api/v1/optumrx/medical_ack`

Receive an acknowledgement for a medical accumulator claim we sent to OptumRx.

Requires scope: optumrx:write

The acknowledgement is persisted idempotently and 202'd. Reconciling it
against the originating medical claim happens downstream. No outbound ack is
owed for this direction (we are the one being acknowledged).

## Request body

- OptumRxMedicalAckRequest — Request schema for the OptumRx NRT medical accumulator acknowledgement. Acknowledges a medical accumulator claim we sent to OptumRx elsewhere. Open-dict sections for the same reason as the pharmacy transaction above.
  - `requestContext` object
  - `medicalAcknowledgementContent` object

## Response `202`

Accepted

- OptumRxHandshakeResponse — Synchronous handshake returned to OptumRx (OptumRx ``HandshakeResponse``). Mirrors the OptumRx NRT contract: a ``responseCode``/``responseStatus`` plus a ``partnerCorrelationId`` that ties our stored record to OptumRx's request.
  - `responseCode` string, required
  - `responseStatus` string, required
  - `partnerCorrelationId` string, required

---

[API](https://skmtc.net/cloverhealth/apis/clover-api.md) · [All operations](https://skmtc.net/cloverhealth/apis/clover-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloverhealth/clover-api/revisions/28797307aae6/schema)