Page Comparison

...

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.

Environment	URL
UAT	https://directory-uat.mi-cie.org/v1/swagger#/services/get_services_complete https://directory-uat.mi-cie.org/v1/swagger#/services/get_services_complete__serviceId_

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
`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.

Code Block
[]

200

Successful retrieval of a service complete record.

Code Block
[ { "id": 1, "organization_id": 969, "location_id": 970, "source_service_id":

"1106

1106,
    "source_id_programAtSite": 78189075,
    "source_id_program": 78143321,
    "source": "icarol",
    "program_id":

2048

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": "

Interpretation

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": "

2048

213229",
        "

organization_id

name": "

969

Stephanie Crider",
        "

location_id

email": "

970

scrider@swmichigancac.org",
        "

service_id

title": "

1

Family Advocate",
        "

service_at_location_id

hasPhone": "0",
        "department": "",
        "

name

service_id": "",
        "

title

location_id": "",
        "

department

organization_id": "",
        "

email

source_service_id": "1106",
        "

hasPhone

service_at_location_id": "

1

"
      }
    ],
    "regular_schedule": [
      {
        "id": "

9212

1222828",
        "

organization_id

weekday": "",
        "

service

opens_

id

at": "

1

",
        "

service

closes_at

_location_id

": "",
        "

weekday

service_id": "",
        "

opens

site_

at

hours": "",
        "

closes

service_

at

hours": "Mon, Wed 9am-8pm; Tue, Thu-Fri 9am-5pm",
        "

administrative

organization_

hours

id": "",
        "source_service_

hours

id": "1106"

Mon

and

Wed

8:30am-8pm;

Tue

and

Thu 8:30am-5pm; Fri 8:30am-4pm

  "administrative_hours": "",
        "

site_hours

service_at_location_id": ""
      }
    ],
    "

phones

schedule": [
      {
        "id": "

18427

39",
        "

organization_id

byday": "SU",
        "

service_id

notes": "

1

",
        "

service

opens_at

_location_id

": "03:08",
        "

number

closes_at": "

2695569640

15:08",
        "

extension

service_id": "1",

"phone_type_hierarchy"

"description": "

1

",
        "

type

source_service_id": "

Main",

"
      }
    ],
    "

department

phones":

"",

 [
      {
        "

language

id": "2124953",
        "

description

type": "

"

Main Site Phone",

}

]

"number": "2695569640",

"service_taxonomy":

[

   "language": "",

{

id

extension": "

8192

",
        "

service_id

department": "

1

",
        "

taxonomy

service_id": "

FN-1500.1900-150

",
        "

taxonomy_detail

description": "

Child Abuse Prevention

",
        "

category

source_service_id": "1106"

Mental Health

Evalua",

},

"subcategory":

"Counseling

Services"

}

]

"id": "1313332",

"physical_address

    "category":

[

"Mental Health Evaluation, Treatment & Supportive

{

Services",
        "

id

subcategory": "

5362

Abuse Counseling",
        "

organization

taxonomy_id": "RP-1400.8000-020.15",
        "

location

taxonomy_

id

detail": "

970

Child Abuse Counseling",
        "

attention

source_service_id": "1106"
      },
      {

"address_1

       "id": "

4938 Niles Road

1313332",
        "

address_2

category": "Child/Adolescent",
        "

address_3

subcategory": "Violence/Abuse Services",
        "

address

taxonomy_

4

id": "RP-1400.8000-020.15",
        "

city

taxonomy_detail": "

Saint

Child Abuse

Joseph

Counseling",
        "

county

source_service_id": "

Berrien

1106"

,

},

"region": "",

     {
        "

state_province

id": "

MI

1313331",
        "

postal_code

category": "

49085

",
        "

country

subcategory": "

USA

",

}

"taxonomy_id": "FN-1500.1900-150",

],

locations

taxonomy_detail":

[

"Child Abuse Prevention",

{

"

"source_service_id": "

970

1106"

,

"organization_id": "969",

],
    "

organization

physical_

name

address":

"CHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGAN",

 [
      {
        "

name

id": "

CHILDREN'S ADVOCACY CENTER OF SOUTHWEST MICHIGAN

32302",
        "

alternate_name

city": "Saint Joseph",
        "

url

county": "

www.swmichigancac.org

Berrien",
        "

description

region": "GRYP"

Located

on

Old

US

31

near

intersection

of

Marquette

Woods Road and US-31

"country": "United States",
        "

accessibility

address_

for_disabilities

1": "4938 Niles Road",
        "

transportation

address_2": "

No public transportation available

",
        "

latitude

address_3": "

42.0225356

",
        "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",
        "

longitude

accessibility_for_disabilities": "

86.4205098

"
      }
    ],
    "service_area_served": [
      {
        "id": "

23308

134785",
        "

service_id

name": "

1

Berrien",
        "type": "county",
        "service_id":

"name

"",
        "source_service_id": "

Berrien

1106"
      },
      {
        "id": "134786",

{

id

name": "

23309

Cass",
        "

service_id

type": "

1

county",
        "

type

service_id": "

county

",
        "

name

source_service_id": "

Cass

1106"
      },
      {
        "id": "

23310

134787",
        "

service_id

name": "

1

Van Buren",
        "type": "county",
        "

name

service_id": ""

Van

Buren"

}

"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.

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

...

Versions Compared

Old Version 8

New Version Current

Key

Swagger Definitions

Headers

Request

Response

Example CURL for this API Call