GET \taxonomy\categoryset

Introduction

This API will allow the use to query and retrieve a list of the taxonomy codes that are associated with the category set.

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

Environment	URL
UAT	GET https://directory-uat.mi-cie.org/v1/taxonomy/categoryset
Production	GET https://directory.mi-cie.org/v1/taxonomy/categoryset

Swagger Definitions

The following are the URLs for this API.

Environment	URL

Environment	URL
UAT	https://directory-uat.mi-cie.org/v1/swagger#/taxonomy%2Fcategoryset/get_taxonomy_categoryset

Headers

The following will be headers that will need to be supplied

Header	Description

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

Data Element	Description	Default
Query String
`query`	A query parameter that will filter out the services that will be returned. This is an json object and
`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 1000.	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

HTTP Status Code

Description

Response Example

200

Successful retrieval of a person record.

[
  {
    "id": 1,
    "taxonomy_id": "NL-3000.1500",
    "category": "Child Care",
    "subcategory": "Child Care Expense Assistance",
    "name": "Child Care Expense Assistance",
    "categoryset": "mi-bridges"
  },
  {
    "id": 2,
    "taxonomy_id": "PH-7000.3300-140",
    "category": "Child Care",
    "subcategory": "Children's In Home Respite Care",
    "name": "Children's In Home Respite Care",
    "categoryset": "mi-bridges"
  },
  {
    "id": 3,
    "taxonomy_id": "LJ-5000.1500",
    "category": "Child Care",
    "subcategory": " Expectant/New Parent Assistance",
    "name": "Childbirth Education",
    "categoryset": "mi-bridges"
  },
  {
    "id": 4,
    "taxonomy_id": "PH-6100.1800",
    "category": "Child Care",
    "subcategory": " Expectant/New Parent Assistance",
    "name": "Expectant/New Parent Assistance",
    "categoryset": "mi-bridges"
  },
  {
    "id": 5,
    "taxonomy_id": "PN-8100.6500-680",
    "category": "Child Care",
    "subcategory": " Expectant/New Parent Assistance",
    "name": "Pregnancy/Childbirth Support Groups",
    "categoryset": "mi-bridges"
  },
  {
    "id": 6,
    "taxonomy_id": "HH-7920",
    "category": "Child Care",
    "subcategory": "Parenting Skills",
    "name": "School Based Teen Parent/Pregnant Teen Programs",
    "categoryset": "mi-bridges"
  },
  {
    "id": 7,
    "taxonomy_id": "PH-6100.6700",
    "category": "Child Care",
    "subcategory": "Parenting Skills",
    "name": "Parenting Materials",
    "categoryset": "mi-bridges"
  },
  {
    "id": 8,
    "taxonomy_id": "PH-6100.3300",
    "category": "Child Care",
    "subcategory": "Parenting Skills",
    "name": "Home Based Parenting Education",
    "categoryset": "mi-bridges"
  },
  {
    "id": 9,
    "taxonomy_id": "PH-6100.1700",
    "category": "Child Care",
    "subcategory": "Parenting Skills",
    "name": "Disability Related Parenting Programs",
    "categoryset": "mi-bridges"
  },
  {
    "id": 10,
    "taxonomy_id": "PH-6100.6600",
    "category": "Child Care",
    "subcategory": "Parenting Skills",
    "name": "Parenting Helplines",
    "categoryset": "mi-bridges"
  }
]

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.

{
  "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"
}

Example CURL for this API Call

The following is an example CURL for calling this api.