GET /appointments/tax
Introduction
This API will enable the API user to get a list of appointment per a type of appointment.
Authorization
The authorization will contain an API key and also will use an OAuth2 access token. An API key will be provided to each client that intends to consume this API. A development key and also a separate production key will be provided. If this key is not included then an authorization error will be returned.
The process for getting an OAuth2 token can be found here Authorization
Scope Needed For This API
SouthEast Michigan Hub - semi-cie.hub/app_tax_readÂ
Rest URL
The following are the URLs for this API. Please note that base url for the region you are looking for can be found here Community Information Exchange Hub Region URL
Environment | URL |
---|---|
Development | GET https://hub-dev.{cie-region}.org/v1/appointments/tax |
UAT | GET https://hub-uat.{cie-region}.org/v1/appointments/tax |
Production | GET https://hub.{cie-region}.org/v1/appointments/tax |
Headers
The following will be headers that will need to be supplied
Header | Description |
---|---|
x-api-key | This will be a key that will provided by a community information exchange administrator. |
ContentType | application/json |
Authorization | This will be the access token that was retrieved using your client id and secret |
Request
Note that the person ID passed as a parameter in the URL as documented in the REST URL section.
Data Element | Description | Required |
---|---|---|
Query String | ||
| This will be the start date of the query | X |
| This will be the end date of the query | X |
Â
Response
The following will be the response values from the calling of the API. The error responses will conform ]to the following specification. RFC 7807: Problem Details for HTTP APIs . Please note that all responses will also include a instance value which will uniquely identify the specific request that was made. This ensures uniqueness even if the patient was referred to the CIE multiple times.
Â
Data Element | Description | Required |
---|---|---|
Body | ||
| The type of appointment. | |
| The name of the organization for the appointment | |
| The id of the organization from the social services directory | |
| The address of the organization that the appointment | |
| The date and time that the appointment will be available | |
| The date that the appointment will be available | |
| The time that the appointment will be available | |
| This is the start time for the appointment | |
| This is the end time for the appointment | |
| Â | |
| Â |
HTTP Status Code | Description | Response Example |
---|---|---|
200 | Successful retrieval of a person record. Â | {
"appointments" : [{
"type": ""
"organizationName": "Detroit Metro",
"organizationId": 12344,
"address": "111 Main Street",
"city": "Gothem",
"state": "MI",
"zip": "49456"
"timeSlots": [
{
"availableDateTime": "",
"availableDate": "",
"availableTime": "",
"availableRange": {"start": "", "end":"", "startUTC": "", "endUTC": "", "numberSlots": 5}
}
]
},
]
instance: "347984t9"
}
 |
403 | Request is unauthorized and will not be processed. This will happen if the authorization header does not contain a valid client id and secret. Â | Â {
"type": "cie/unauthorized",
"title": "Request is not authorized
to perform this operation",
"detail": "The x-api-key header may be
missing or is invalid",
"instance":"4abdf0d4-e934-5575513f6d5"
}
  |
400 | Request is malformed and will not be processed. Â | {
"type": "cie/validation-error",
"title": "Your request parameters
didn't validate.",
"instance":"4abdf0d4-e934-5575513f6d5"
}
 |
Â
Â
Â
Example CURL for this API Call
The following is an example CURL for calling this api. Also note that there are sample Referral Id’s that are in the CIE Hub development environment that can be used for testing purposes
Â