GET \services\complete
- Pete Richardson
- Jonathan Draugelis
Introduction
This API will allow the user to query for complete information on services. The API can be called without passing a ID parameter in the path to get a specific service. Please note that if you are searching for a list of services and don’t need all the information the \services call will be faster.
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 - mi-cie.hub/read
Â
Rest URL
The following are the URLs for this API.
Environment | URL |
|---|---|
UAT | GET https://directory-uat.mi-cie.org/v1/services/complete/{id} GET https://directory-uat.mi-cie.org/v1/services/complete/ |
Production | GET https://directory.mi-cie.org/v1/services/complete/{id} GET https://directory.mi-cie.org/v1/services/complete |
Swagger Definitions
The following are the URLs for this API.
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 | Default |
|---|---|---|
Path Parameter | ||
| This will be the service id of the requested record in the directory. *Please note that this is only needed if you want to get a specific service payload for a ID. | Â |
Query String | ||
| A query parameter that will filter out the services that will be returned. This is an json object and The following lists commonly used query strings used for this API \services | Common Queries | Â |
| This will be which page of data that the user wants to be returned. | Default to Page 1 |
| This will be the number of records that can be queried at a time. The maximum that can be queried is 30. | Default to 10 |
Â
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 .
HTTP Status Code | Description | Response Example |
|---|---|---|
200 | Successful call with no service matching the query passed in. | Â [] |
200 | Successful retrieval of a service complete record. Â | [
{
"id": 1,
"organization_id": 969,
"location_id": 970,
"source_service_id": 1106,
"source_id_programAtSite": 78189075,
"source_id_program": 78143321,
"source": "icarol",
"program_id": null,
"program": "CHILDREN'S ADVOCACY CENTER",
"name": "COUNSELING SERVICES AND PREVENTION FOR CHILDREN WHO ARE ABUSED",
"alternate_name": null,
"description": "Provides forensic interviews for sexually abused children, counseling services for sexually abused children, including adults survivors of child sexual abuse, and prevention education.",
"url": "www.swmichigancac.org",
"email": "info@swmichigancac.org",
"status": 1,
"interpretation_services": null,
"application_process": "- Referral required from Child Protective Services or Law Enforcement for forensic interviewing services - Therapy services available to children and adult survivors of child sexual abuse",
"wait_time": null,
"fees": "No fees",
"schedule_notes": "Mon, Wed 9am-8pm; Tue, Thu-Fri 9am-5pm",
"accreditations": null,
"licenses": null,
"eligibility": "Children and families of suspected child abuse in Southwest Michigan",
"language": "Translation services available",
"payment_accepted": "Not applicable",
"required_document": "Referral information",
"service_area": "Berrien, Cass and Van Buren Counties",
"area_served_description": "Berrien, Cass and Van Buren Counties",
"region": "GRYP",
"contacts": [
{
"id": "213229",
"name": "Stephanie Crider",
"email": "scrider@swmichigancac.org",
"title": "Family Advocate",
"hasPhone": "0",
"department": "",
"service_id": "",
"location_id": "",
"organization_id": "",
"source_service_id": "1106",
"service_at_location_id": ""
}
],
"regular_schedule": [
{
"id": "1222828",
"weekday": "",
"opens_at": "",
"closes_at": "",
"service_id": "",
"site_hours": "",
"service_hours": "Mon, Wed 9am-8pm; Tue, Thu-Fri 9am-5pm",
"organization_id": "",
"source_service_id": "1106",
"administrative_hours": "",
"service_at_location_id": ""
}
],
"schedule": [
{
"id": "39",
"byday": "SU",
"notes": "",
"opens_at": "03:08",
"closes_at": "15:08",
"service_id": "1",
"description": "",
"source_service_id": ""
}
],
"phones": [
{
"id": "2124953",
"type": "Main Site Phone",
"number": "2695569640",
"language": "",
"extension": "",
"department": "",
"service_id": "",
"description": "",
"location_id": "970",
"confidential": "0",
"organization_id": "",
"source_service_id": "",
"phone_type_hierarchy": "1000",
"service_at_location_id": ""
}
],
"service_taxonomy": [
{
"id": "1313333",
"category": "Mental Health Evaluation, Treatment & Supportive Services",
"subcategory": "Counseling Services",
"taxonomy_id": "RP-1400.8000-800",
"taxonomy_detail": "Sexual Assault Counseling",
"source_service_id": "1106"
},
{
"id": "1313332",
"category": "Mental Health Evaluation, Treatment & Supportive Services",
"subcategory": "Abuse Counseling",
"taxonomy_id": "RP-1400.8000-020.15",
"taxonomy_detail": "Child Abuse Counseling",
"source_service_id": "1106"
},
{
"id": "1313332",
"category": "Child/Adolescent",
"subcategory": "Violence/Abuse Services",
"taxonomy_id": "RP-1400.8000-020.15",
"taxonomy_detail": "Child Abuse Counseling",
"source_service_id": "1106"
},
{
"id": "1313331",
"category": "",
"subcategory": "",
"taxonomy_id": "FN-1500.1900-150",
"taxonomy_detail": "Child Abuse Prevention",
"source_service_id": "1106"
}
],
"physical_address": [
{
"id": "32302",
"city": "Saint Joseph",
"county": "Berrien",
"region": "GRYP",
"country": "United States",
"address_1": "4938 Niles Road",
"address_2": "",
"address_3": "",
"address_4": "",
"attention": "",
"is_physical": "1",
"location_id": "970",
"postal_code": "49085",
"state_province": "MI",
"organization_id": ""
}
],
"locations": [
{
"id": "970",
"url": "www.swmichigancac.org",
"name": "CHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGAN",
"source": "icarol",
"latitude": "42.0225356",
"longitude": "86.4205098",
"source_id": "78174387",
"description": "Located on Old US 31 near intersection of Marquette Woods Road and US-31",
"alternate_name": "BERRIEN COUNTY COUNCIL FOR CHILDREN, CHILDRENS ADVOCACY CENTER OF SOUTHWEST MICHIGAN",
"schedule_notes": "Mon, Wed 9am-8pm; Tue, Thu-Fri 9am-5pm",
"transportation": "No public transportation available",
"organization_id": "969",
"organization_name": "CHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGAN",
"accessibility_for_disabilities": ""
}
],
"service_area_served": [
{
"id": "134785",
"name": "Berrien",
"type": "county",
"service_id": "",
"source_service_id": "1106"
},
{
"id": "134786",
"name": "Cass",
"type": "county",
"service_id": "",
"source_service_id": "1106"
},
{
"id": "134787",
"name": "Van Buren",
"type": "county",
"service_id": "",
"source_service_id": "1106"
}
]
}
]Â |
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. Â | Â {
"message": "Forbidden"
}
  |
400 | Request is malformed and will not be processed. Â | Â |
500 | INTERNAL SERVER ERROR | |
401 | Unauthorized | Â |
502 | Bad Gateway. Our API services maybe down | Â |
Example CURL for this API Call
The following is an example CURL for calling this api.
Â