Creates a new Statement of Medical Necessity (SMN) with all related data.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The requested API version

Body Params

Request model for creating a Statement of Medical Necessity (SMN) statement of medical necessity.

int64
required
≥ 1

The patient encounter ID to associate the document with.

date-time | null

The document date. Defaults to current date if not provided.

date-time | null

The expiration date. Defaults to DocumentDate + 12 months if not provided.

int32 | null
1 to 3

The document certification type (1=Initial, 2=Revised, 3=Recertification). Defaults to 1 (Initial).

int64 | null

The patient policy ID to associate with the document. Optional.

int64 | null

The company ID for the statement of medical necessity.

boolean | null

Whether the document is valid for the patient's lifetime. Defaults to false.

boolean | null

Whether the document is non-renewable. Defaults to false.

string | null

Length of need (e.g., "6", "12"). Stored as VARCHAR(10) in the database.

date-time | null

The signed date of the document.

date-time | null

The last seen date for the patient.

string | null

The name/title of the document.

int64 | null

The SMN template ID.

string | null

Prognosis text.

string | null

Reason heading text.

string | null

Therapies provided text.

lines
array of objects | null

HCPCS/item lines for the document. If not provided, one empty line is created by default.

lines
diagnoses
array of objects | null

Diagnosis IDs to link to the document. If not provided, defaults are not auto-populated via the API.

diagnoses
notes
array of objects | null

Long-text notes for the document. If not provided, a default WrittenOrderSMNText note is created.

notes
fieldValues
array of objects | null

Short field values for the document.

fieldValues
string
required
length between 0 and 100

The username of the user creating the document.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json