---
title: "Update a practitioner's Social Security Number"
method: PUT
path: "/practitioners/{id}/ssn"
tags: ["Practitioner"]
---

# Update a practitioner's Social Security Number

`PUT /practitioners/{id}/ssn`

Updates the Social Security Number for the specified practitioner. This operation requires elevated permission (`PRACTITIONER_UPDATE_SSN`) beyond standard practitioner update access. Use this only when the SSN on record is incorrect or needs to be set for the first time; SSN is sensitive PII, so access is restricted and audited. `{id}` is the `certifyPractitionerId`. The SSN must be exactly 9 plain digits with no dashes or spaces. This operation always writes — there is no read-then-compare, so resubmitting the same value still performs a write.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string

## Request body

- SsnUpdateRequest
  - `ssn` string, required — Social Security Number

## Response `200`

Confirmation message that the SSN was updated (no `ssn` field is returned; use `GET /practitioners/{id}/ssn` to retrieve the value).

## Other responses

- `400` — Bad request - Invalid input
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Practitioner not found
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)