POST api/AppointmentRequests

Creates a new appointment requests.

Request Information

URI Parameters

None.

Body Parameters

Model used to retrieve or set information about an appointment.

AppointmentRequestModel
NameDescriptionTypeAdditional information
AccountNumber

URL name of the practice for which the appointment is requested (Required).

 string

None.
AppointmentRequestId

Unique ID of appointment request.

 globally unique identifier

None.
AppointmentId

Unique ID of appointment.

 globally unique identifier

None.
PatientId

Unique ID of patient.

 globally unique identifier

None.
LocationId

Unique ID of location (Required).

 globally unique identifier

None.
NewPatient

Indicates whether new patient or not.

 boolean

None.
HasEyeExamAtThisLocation

Indication if examination is at the given location.

 boolean

None.
VisionInsuranceCarrier

Vision insurance carrier

 string

None.
VisionGroupNumber

Vision group number.

 string

None.
VisionPolicyNumber

Vision policy number.

 string

None.
MedicalInsuranceCarrier

Medical insurance carrier.

 string

None.
MedicalGroupNumber

Medical group number.

 string

None.
MedicalPolicyNumber

Medical policy number.

 string

None.
DoctorId

Unique ID of doctor.

 globally unique identifier

None.
Comments

Comments for the appointment request.

 string

None.
RequestedDate

Requested Date of the appointment request.

 date

None.
PatientEmailAddress

Email address of patient.

 string

None.
PhoneNumberIsMobile

Indicates if the phone number can be used to receive text messages.

 boolean

None.
PhoneNumber

Phone number of the patient.

 string

None.
CountryId

Unique ID of country.

 globally unique identifier

None.
AppointmentRequestReasonId

Unique ID of appointment request reason (Required).

 globally unique identifier

None.
AnotherPerson

Indicates if the appointment request is being created for another person that is not a relative of the current patient.

 boolean

None.
FirstName

First name of the person (Required).

 string

None.
MiddleName

Middle name of the person.

 string

None.
LastName

Last name of the person (Required).

 string

None.
DateOfBirth

Date of birth of the person (Required).

 date

None.
PatientSexId

Patient's sex ID of the model in the portal.

 integer

None.
Username

If the person requesting the appointment wants to create an account in the portal, send the username in this property.

 string

None.
Password

If the person requesting the appointment wants to create an account in the portal, send the passwod in this property.

 string

None.
TermsOfUseAccepted

Indicates if user has accepted the terms of use.

 boolean

None.

Request Formats

application/json, text/json

Sample: 
{
  "AccountNumber": "sample string 1",
  "AppointmentRequestId": "54214a3e-5b37-4068-859a-4d72d83a87f9",
  "AppointmentId": "64883462-6fe5-4a1d-9623-edd60848261c",
  "PatientId": "b366d350-0048-47c9-8149-af36ec673d7c",
  "LocationId": "279734b8-2fad-4488-9153-8d838b66a3f9",
  "NewPatient": true,
  "HasEyeExamAtThisLocation": true,
  "VisionInsuranceCarrier": "sample string 6",
  "VisionGroupNumber": "sample string 7",
  "VisionPolicyNumber": "sample string 8",
  "MedicalInsuranceCarrier": "sample string 9",
  "MedicalGroupNumber": "sample string 10",
  "MedicalPolicyNumber": "sample string 11",
  "DoctorId": "abce9b3c-a6ac-4e25-8018-d2d7b3de4771",
  "Comments": "sample string 12",
  "RequestedDate": "2026-04-01T22:08:31.5026376+00:00",
  "PatientEmailAddress": "sample string 14",
  "PhoneNumberIsMobile": true,
  "PhoneNumber": "sample string 16",
  "CountryId": "caa78cf8-20c5-4d28-b8c8-19b15cc12fbd",
  "AppointmentRequestReasonId": "cf999c85-ac2f-414a-bf9d-ee758293a9e5",
  "AnotherPerson": true,
  "FirstName": "sample string 19",
  "MiddleName": "sample string 20",
  "LastName": "sample string 21",
  "DateOfBirth": "2026-04-01T22:08:31.5026376+00:00",
  "PatientSexId": 1,
  "Username": "sample string 23",
  "Password": "sample string 24",
  "TermsOfUseAccepted": true
}

application/xml, text/xml

Sample: 
<AppointmentRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GlobalPortal.Mobile.Api.Models.AppointmentRequests">
  <AccountNumber>sample string 1</AccountNumber>
  <AnotherPerson>true</AnotherPerson>
  <AppointmentId>64883462-6fe5-4a1d-9623-edd60848261c</AppointmentId>
  <AppointmentRequestId>54214a3e-5b37-4068-859a-4d72d83a87f9</AppointmentRequestId>
  <AppointmentRequestReasonId>cf999c85-ac2f-414a-bf9d-ee758293a9e5</AppointmentRequestReasonId>
  <Comments>sample string 12</Comments>
  <CountryId>caa78cf8-20c5-4d28-b8c8-19b15cc12fbd</CountryId>
  <DateOfBirth>2026-04-01T22:08:31.5026376+00:00</DateOfBirth>
  <DoctorId>abce9b3c-a6ac-4e25-8018-d2d7b3de4771</DoctorId>
  <FirstName>sample string 19</FirstName>
  <HasEyeExamAtThisLocation>true</HasEyeExamAtThisLocation>
  <LastName>sample string 21</LastName>
  <LocationId>279734b8-2fad-4488-9153-8d838b66a3f9</LocationId>
  <MedicalGroupNumber>sample string 10</MedicalGroupNumber>
  <MedicalInsuranceCarrier>sample string 9</MedicalInsuranceCarrier>
  <MedicalPolicyNumber>sample string 11</MedicalPolicyNumber>
  <MiddleName>sample string 20</MiddleName>
  <NewPatient>true</NewPatient>
  <Password>sample string 24</Password>
  <PatientEmailAddress>sample string 14</PatientEmailAddress>
  <PatientId>b366d350-0048-47c9-8149-af36ec673d7c</PatientId>
  <PatientSexId>1</PatientSexId>
  <PhoneNumber>sample string 16</PhoneNumber>
  <PhoneNumberIsMobile>true</PhoneNumberIsMobile>
  <RequestedDate>2026-04-01T22:08:31.5026376+00:00</RequestedDate>
  <TermsOfUseAccepted>true</TermsOfUseAccepted>
  <Username>sample string 23</Username>
  <VisionGroupNumber>sample string 7</VisionGroupNumber>
  <VisionInsuranceCarrier>sample string 6</VisionInsuranceCarrier>
  <VisionPolicyNumber>sample string 8</VisionPolicyNumber>
</AppointmentRequestModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

AppointmentRequestModel
NameDescriptionTypeAdditional information
AccountNumber

URL name of the practice for which the appointment is requested (Required).

 string

None.
AppointmentRequestId

Unique ID of appointment request.

 globally unique identifier

None.
AppointmentId

Unique ID of appointment.

 globally unique identifier

None.
PatientId

Unique ID of patient.

 globally unique identifier

None.
LocationId

Unique ID of location (Required).

 globally unique identifier

None.
NewPatient

Indicates whether new patient or not.

 boolean

None.
HasEyeExamAtThisLocation

Indication if examination is at the given location.

 boolean

None.
VisionInsuranceCarrier

Vision insurance carrier

 string

None.
VisionGroupNumber

Vision group number.

 string

None.
VisionPolicyNumber

Vision policy number.

 string

None.
MedicalInsuranceCarrier

Medical insurance carrier.

 string

None.
MedicalGroupNumber

Medical group number.

 string

None.
MedicalPolicyNumber

Medical policy number.

 string

None.
DoctorId

Unique ID of doctor.

 globally unique identifier

None.
Comments

Comments for the appointment request.

 string

None.
RequestedDate

Requested Date of the appointment request.

 date

None.
PatientEmailAddress

Email address of patient.

 string

None.
PhoneNumberIsMobile

Indicates if the phone number can be used to receive text messages.

 boolean

None.
PhoneNumber

Phone number of the patient.

 string

None.
CountryId

Unique ID of country.

 globally unique identifier

None.
AppointmentRequestReasonId

Unique ID of appointment request reason (Required).

 globally unique identifier

None.
AnotherPerson

Indicates if the appointment request is being created for another person that is not a relative of the current patient.

 boolean

None.
FirstName

First name of the person (Required).

 string

None.
MiddleName

Middle name of the person.

 string

None.
LastName

Last name of the person (Required).

 string

None.
DateOfBirth

Date of birth of the person (Required).

 date

None.
PatientSexId

Patient's sex ID of the model in the portal.

 integer

None.
Username

If the person requesting the appointment wants to create an account in the portal, send the username in this property.

 string

None.
Password

If the person requesting the appointment wants to create an account in the portal, send the passwod in this property.

 string

None.
TermsOfUseAccepted

Indicates if user has accepted the terms of use.

 boolean

None.

Response Formats

application/json, text/json

Sample: 
{
  "AccountNumber": "sample string 1",
  "AppointmentRequestId": "d59ae731-9da9-4f32-9d7f-08dde3c5180b",
  "AppointmentId": "cdafd285-8e21-4b09-9b1c-8ce49e41daa3",
  "PatientId": "b571951e-7281-437e-9bb0-bfee25ba0b01",
  "LocationId": "103992fc-c0bd-46b5-862b-847788110943",
  "NewPatient": true,
  "HasEyeExamAtThisLocation": true,
  "VisionInsuranceCarrier": "sample string 6",
  "VisionGroupNumber": "sample string 7",
  "VisionPolicyNumber": "sample string 8",
  "MedicalInsuranceCarrier": "sample string 9",
  "MedicalGroupNumber": "sample string 10",
  "MedicalPolicyNumber": "sample string 11",
  "DoctorId": "f4cd5b82-5a6c-4639-a7a3-6b659233a90b",
  "Comments": "sample string 12",
  "RequestedDate": "2026-04-01T22:08:31.5184734+00:00",
  "PatientEmailAddress": "sample string 14",
  "PhoneNumberIsMobile": true,
  "PhoneNumber": "sample string 16",
  "CountryId": "25e1d87e-8c0d-42d1-86e7-f4ec550e9146",
  "AppointmentRequestReasonId": "0a417309-f5f6-44c2-9dee-79edb60076e4",
  "AnotherPerson": true,
  "FirstName": "sample string 19",
  "MiddleName": "sample string 20",
  "LastName": "sample string 21",
  "DateOfBirth": "2026-04-01T22:08:31.5184734+00:00",
  "PatientSexId": 1,
  "Username": "sample string 23",
  "Password": "sample string 24",
  "TermsOfUseAccepted": true
}

application/xml, text/xml

Sample: 
<AppointmentRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GlobalPortal.Mobile.Api.Models.AppointmentRequests">
  <AccountNumber>sample string 1</AccountNumber>
  <AnotherPerson>true</AnotherPerson>
  <AppointmentId>cdafd285-8e21-4b09-9b1c-8ce49e41daa3</AppointmentId>
  <AppointmentRequestId>d59ae731-9da9-4f32-9d7f-08dde3c5180b</AppointmentRequestId>
  <AppointmentRequestReasonId>0a417309-f5f6-44c2-9dee-79edb60076e4</AppointmentRequestReasonId>
  <Comments>sample string 12</Comments>
  <CountryId>25e1d87e-8c0d-42d1-86e7-f4ec550e9146</CountryId>
  <DateOfBirth>2026-04-01T22:08:31.5184734+00:00</DateOfBirth>
  <DoctorId>f4cd5b82-5a6c-4639-a7a3-6b659233a90b</DoctorId>
  <FirstName>sample string 19</FirstName>
  <HasEyeExamAtThisLocation>true</HasEyeExamAtThisLocation>
  <LastName>sample string 21</LastName>
  <LocationId>103992fc-c0bd-46b5-862b-847788110943</LocationId>
  <MedicalGroupNumber>sample string 10</MedicalGroupNumber>
  <MedicalInsuranceCarrier>sample string 9</MedicalInsuranceCarrier>
  <MedicalPolicyNumber>sample string 11</MedicalPolicyNumber>
  <MiddleName>sample string 20</MiddleName>
  <NewPatient>true</NewPatient>
  <Password>sample string 24</Password>
  <PatientEmailAddress>sample string 14</PatientEmailAddress>
  <PatientId>b571951e-7281-437e-9bb0-bfee25ba0b01</PatientId>
  <PatientSexId>1</PatientSexId>
  <PhoneNumber>sample string 16</PhoneNumber>
  <PhoneNumberIsMobile>true</PhoneNumberIsMobile>
  <RequestedDate>2026-04-01T22:08:31.5184734+00:00</RequestedDate>
  <TermsOfUseAccepted>true</TermsOfUseAccepted>
  <Username>sample string 23</Username>
  <VisionGroupNumber>sample string 7</VisionGroupNumber>
  <VisionInsuranceCarrier>sample string 6</VisionInsuranceCarrier>
  <VisionPolicyNumber>sample string 8</VisionPolicyNumber>
</AppointmentRequestModel>