...
The following are the URLs for this API.
Swagger Definitions
The following are the URLs for this API.
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 |
id
| 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 |
query
| 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 https://brightstreetgroup.atlassian.net/wiki/spaces/CIEP/pages/1576763393/services#Common-Queries | |
page
| This will be which page of data that the user wants to be returned. | Default to Page 1 |
per_page
| 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. https://tools.ietf.org/html/rfc7807 .
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. | Code Block |
---|
[
{
"id": 1,
"organization_id": 969,
"location_id": 970,
"source_service_id": 1106,
"source_id_programAtSite": |
|
null78189075,
"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": |
|
null"www.swmichigancac.org",
"email": |
|
null"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": " |
|
InterpretationTranslation 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": [ |
|
],"regular_schedule":[
128090organization_idname": "Stephanie Crider",
" |
|
service_idemail": "scrider@swmichigancac.org",
" |
|
source_service_id1106service_at_location_idweekdayopensatclosesatadministrativehoursid": "",
"source_service_ |
|
hoursMon and Wed 8:30am-8pm; Tue and Thu 8:30am-5pm; Fri 8:30am-4pmsite_hoursservice_at_location_id": ""
}
],
" |
|
phonesregular_schedule": [
{
"id": " |
|
317064organization_idserviceidsourceservice_id1106at_location_idnumber2695569640extensionservice_hours": "Mon, Wed 9am-8pm; Tue, Thu-Fri 9am-5pm",
" |
|
phonetype_hierarchy1typeMaindepartmentadministrative_hours": "",
" |
|
languageservice_at_location_id": "" |
|
,"description": "",
confidential"0"}
],service_taxonomy[
{ "id169075source_service_id1106taxonomyidFN-1500.1900-150taxonomydetailChild Abuse Prevention15:08",
"service_id": "1",
" |
|
categorysubcategory,{"id": "169076",source_service_1106taxonomy_idRP-1400.8000-020.15taxonomy_detailChild Abuse CounselingcategoryChild/AdolescentsubcategoryViolence/Abuse Services}, {"department": "",
"service_id": " |
|
169077source_service_id1106taxonomy"RP-1400.8000-020.15"taxonomy_detailChild Abuse CounselingcategoryMental Health Evaluation, Treatment & Supportive ServicessubcategoryAbuse Counseling
}, "phone_type_hierarchy": "1000",
|
|
{ ""service_at_location_id": " |
|
169079",source_id"1106","taxonomy_id": "RP-1400.8000-800",
taxonomy_detailSexual Assault Counseling1313333",
"category": "Mental Health Evaluation, Treatment & Supportive Services",
"subcategory": "Counseling Services" |
|
} ],physicaladdress[ { "5559","organization_id": "",location_970attentioncategory": "Mental Health Evaluation, Treatment & Supportive Services",
" |
|
address_14938Niles Roadaddress2id": "RP-1400.8000-020.15",
" |
|
address3detail": "Child Abuse Counseling",
" |
|
address4,"city":"Saint Joseph",countyBerrienregioncategory": "Child/Adolescent",
" |
|
state_provinceMIViolence/Abuse Services",
" |
|
postalcode49085countryUSA} "source_service_id": "1106"
|
|
],"locations": [ 970organization_id969organization_nameCHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGANsourcetaxonomy_id": "FN-1500.1900-150",
" |
|
sourcedatawarehousenamesource_service_id": "1106" |
|
CHILDREN'SADVOCACYCENTEROFSOUTHWEST MICHIGAN",alternatename "",urlwww.swmichigancac.orgdescriptionLocatedonOldUS31nearintersectionofMarquetteWoodsRoad and US-31"accessibility_for_disabilities"region": "GRYP",
"country": "United States",
"address_1": "4938 Niles Road",
"address_2": "",
|
|
"transportation": "No public transportation available"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",
" |
|
latitude42.0225356CHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGAN",
" |
|
longitudeaccessibility_for_disabilities": " |
|
86.4205098"
}
],
"service_area_served": [
{
"id": " |
|
186123service_idsource_service_id1106typecounty"name"Berrien186124service_idsource_service_id1106typecountynameCass186125service_idsource_service_id1106typecountynameVan Buren |
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. | Code Block |
---|
{
"message": "Forbidden"
}
|
|
400 | Request is malformed and will not be processed. | Code Block |
---|
{
"type": "cie-directory/validation-error",
"title": "Invalid Parameter",
"detail": "parameter per_page was greater then the max allowed for this endpoint. per_page: 10000 max_allowed: 100",
"instance": "237869a1-67f0-4a68-9500-734b3956517b"
}
|
|
500 | INTERNAL SERVER ERROR | Code Block |
---|
{
"type": "cie-directory/unkown-error",
"title": "There was an error retrieving the services",
"detail": "{\n\t\"stack\": \"Error: Error message\\n at ServiceController.GetServicesAllComplete (/var/task/src/services/service-controller.js:214:13)\\n at processTicksAndRejections (internal/process/task_queues.js:97:5)\\n at async Runtime.exports.getServicesAllCompleteHandler [as handler] (/var/task/src/services/handler.js:73:22)\",\n\t\"message\": \"Error message\"\n}",
"instance": "7a025b91-f1ff-4e4f-be75-42390fb02dd2"
}
|
|
401 | Unauthorized | Code Block |
---|
{
"message": "Unauthorized"
}
|
|
502 | Bad Gateway. Our API services maybe down | Code Block |
---|
{
"message": "Internal Server Error"
}
|
|
Example CURL for this API Call
...