---
title: "Submit Patient"
method: POST
path: "/api/v2/patients"
tags: ["Patients"]
---

# Submit Patient

`POST /api/v2/patients`

## Request body

- ApiPatient
  - `address_city` string, required — The patient's home city.
  - `address_lines` string[] — The patient's home street address. This should not include the patient's city, state, or zip code.
  - `address_state` string, required — The patient's home state.
  - `consent` ApiConsent[] — The patient's consent information.
    - `consent_date` string, required
    - `partner` string, required
    - `permission` 'permit' | 'deny', required
  - `date_of_birth` string, required — The patient's date of birth, this field is required and must be of the format YYYY-MM-DD.
  - `email` string — The patient's email, must be a valid email address.
  - `family_name` string, required — The patient's family name (last name), this field is required.
  - `gender` string, required — The patient's gender, must be either FEMALE or MALE.
  - `given_name` string, required — The patient's given name (first name), this field is required.
  - `particle_patient_id` string — The Particle Assigned Patient ID. Output only.
  - `patient_id` string, required — The unique patient id in an external system.
  - `postal_code` string, required — The patient's home postal (zip) code.
  - `ssn` string — The patient's social security number, must be a valid US social security number.
  - `telephone` string — The patient's telephone number.

## Response `200`

OK

- ApiPatient
  - `address_city` string, required — The patient's home city.
  - `address_lines` string[] — The patient's home street address. This should not include the patient's city, state, or zip code.
  - `address_state` string, required — The patient's home state.
  - `consent` ApiConsent[] — The patient's consent information.
    - `consent_date` string, required
    - `partner` string, required
    - `permission` 'permit' | 'deny', required
  - `date_of_birth` string, required — The patient's date of birth, this field is required and must be of the format YYYY-MM-DD.
  - `email` string — The patient's email, must be a valid email address.
  - `family_name` string, required — The patient's family name (last name), this field is required.
  - `gender` string, required — The patient's gender, must be either FEMALE or MALE.
  - `given_name` string, required — The patient's given name (first name), this field is required.
  - `particle_patient_id` string — The Particle Assigned Patient ID. Output only.
  - `patient_id` string, required — The unique patient id in an external system.
  - `postal_code` string, required — The patient's home postal (zip) code.
  - `ssn` string — The patient's social security number, must be a valid US social security number.
  - `telephone` string — The patient's telephone number.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `406` — Not Acceptable
- `500` — Internal Server Error

---

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