---
title: "Create a provider listing claim request"
method: POST
path: "/v1/provider-claims"
tags: ["Provider Claims"]
---

# Create a provider listing claim request

`POST /v1/provider-claims`

Starts a claim on an existing, unclaimed provider listing. Only one claim can be pending per listing at a time. The claimant receives a confirmation email and the claim is mirrored to Waggleline for CX review.

## Request body

- object
  - `providerId` string, required — The Charts _id of the listing being claimed
  - `userId` string, required — The claimant user _id
  - `occupation` 'doctor' | 'marketing-manager' | 'medical-assistant' | 'medial-assistant' | 'nurse' | 'office-manager' | 'owner' | 'operations-manager' | 'physician-assistant' | 'receptionist' | 'other', required — The claimant's occupation at the provider
  - `otherInfo` string — Required free-text description when occupation is 'other'
  - `source` string — Where the claim originated (e.g. 'bluehive-provider-signup')

## Response `201`

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)