---
title: "Create Query"
method: POST
path: "/api/v2/patients/{particle_patient_id}/query"
tags: ["Patients"]
---

# Create Query

`POST /api/v2/patients/{particle_patient_id}/query`

## Path parameters

- `particle_patient_id` string, required

## Request body

- ApiQueryParameters
  - `hints` string[] — Postal codes hinting at the believed location of records.
  - `purpose_of_use` string, required — The purpose of use for which this request is being made.
  - `specialties` string[] — The list of specialty searches requested for this patient

## Response `200`

OK

- ApiQueryResponse
  - `external_patient_id` string — The external patient id of the patient.
  - `hints` string[] — Postal codes hinting at the believed location of records.
  - `particle_patient_id` string — The particle patient id that corresponds to the patient that the query is meant to be run against.
  - `purpose_of_use` string — The purpose of use for which this request is being made.
  - `query_id` string — The unique ID of the query that was initiated.
  - `specialties` string[] — The list of specialty searches requested for this patient

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `406` — Not Acceptable
- `429` — Too Many Requests
- `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)