---
title: "Approve or decline a provider listing claim"
method: POST
path: "/v1/provider-claims/{claimId}/review"
tags: ["Provider Claims"]
---

# Approve or decline a provider listing claim

`POST /v1/provider-claims/{claimId}/review`

Concludes a pending claim. Accepting grants the claimant scoped provider roles and marks the listing claimed; declining frees the listing for another claim. The claimant is emailed the outcome. Already-concluded claims return 409.

## Path parameters

- `claimId` string, required

## Request body

- object
  - `status` 'Accepted' | 'Declined', required
  - `reason` string — Reviewer note; included in the decline email
  - `reviewer` string — Reviewer reference for the audit trail (e.g. email)

## Response `200`

Default Response

- object
  - `status` string
  - `claim` object
    - `_id` string
    - `listing` string
    - `user` string
    - `status` string
    - `easyId` string
    - `startedDT` string, date-time
    - `source` string
    - `claimData` object
      - `listingId` string
      - `occupation` string
      - `otherInfo` string
    - `review` object
      - `comment` string
      - `reviewer` string
      - `concludedAt` string, date-time

## Other responses

- `400` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response

---

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