curl --request GET \
--url https://fulfillment.noyo.com/api/v1/groups/{group_id}/renewal_decisions \
--header 'Authorization: Bearer <token>'{
"meta": {
"offset": 0,
"page_num": 1,
"page_size": 20,
"total_records": 1
},
"response": [
{
"body": {
"carriers": [
{
"carrier_id": "bf81f0c4-3105-4240-b62b-aa6de3f607e4",
"lines_of_coverage": {
"dental": {
"open_enrollment_end_date": "2022-01-31",
"open_enrollment_start_date": "2022-01-01",
"plans": [
{
"name": "Dental Plus Plan",
"plan_id": "44bc0f4a-0a94-11ec-9a03-0242ac130003"
}
]
},
"medical": {
"open_enrollment_end_date": "2022-01-31",
"open_enrollment_start_date": "2022-01-01",
"plans": [
{
"name": "Select Plus PPO HDHP Gold BRJJ /C38",
"plan_id": "818e52d4-6c34-4914-b716-a3047c85e468"
},
{
"name": "Select Plus PPO HDHP Silver BRJJ /C38",
"plan_id": "f9897240-87f8-4d9d-a68f-58bc445fe0b2"
},
{
"name": "Select Plus PPO HDHP Bronze BRJJ /C38",
"plan_id": "19437852-3795-4cb4-939c-a86543eabee0"
}
]
}
}
}
]
},
"created": 1557862286,
"group_id": "2613a221-d3c8-4c8a-86d5-e7e885fd1da9",
"id": "b5f2b5f7-0336-45f7-baf1-7e11dfac50a6",
"issues": [
{
"level": "error",
"message": "Life open enrollment start date is 2021-08-01 in carrier system"
},
{
"level": "error",
"message": "LTD Plan not available yet in carrier system"
}
],
"modified": 1557862286,
"renewal_date": "2022-01-01",
"status": "not_ready",
"version": "23be0ba3-1183-4e8e-8e9d-644527414c6e"
}
]
}Get Renewal Decisions by Group
Returns all renewal decisions for a group. This includes the status, which determines whether the carrier is ready to accept member requests for the new plan year. If the status is not_ready, Noyo will return one or more issues, each with a level and message.
curl --request GET \
--url https://fulfillment.noyo.com/api/v1/groups/{group_id}/renewal_decisions \
--header 'Authorization: Bearer <token>'{
"meta": {
"offset": 0,
"page_num": 1,
"page_size": 20,
"total_records": 1
},
"response": [
{
"body": {
"carriers": [
{
"carrier_id": "bf81f0c4-3105-4240-b62b-aa6de3f607e4",
"lines_of_coverage": {
"dental": {
"open_enrollment_end_date": "2022-01-31",
"open_enrollment_start_date": "2022-01-01",
"plans": [
{
"name": "Dental Plus Plan",
"plan_id": "44bc0f4a-0a94-11ec-9a03-0242ac130003"
}
]
},
"medical": {
"open_enrollment_end_date": "2022-01-31",
"open_enrollment_start_date": "2022-01-01",
"plans": [
{
"name": "Select Plus PPO HDHP Gold BRJJ /C38",
"plan_id": "818e52d4-6c34-4914-b716-a3047c85e468"
},
{
"name": "Select Plus PPO HDHP Silver BRJJ /C38",
"plan_id": "f9897240-87f8-4d9d-a68f-58bc445fe0b2"
},
{
"name": "Select Plus PPO HDHP Bronze BRJJ /C38",
"plan_id": "19437852-3795-4cb4-939c-a86543eabee0"
}
]
}
}
}
]
},
"created": 1557862286,
"group_id": "2613a221-d3c8-4c8a-86d5-e7e885fd1da9",
"id": "b5f2b5f7-0336-45f7-baf1-7e11dfac50a6",
"issues": [
{
"level": "error",
"message": "Life open enrollment start date is 2021-08-01 in carrier system"
},
{
"level": "error",
"message": "LTD Plan not available yet in carrier system"
}
],
"modified": 1557862286,
"renewal_date": "2022-01-01",
"status": "not_ready",
"version": "23be0ba3-1183-4e8e-8e9d-644527414c6e"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the group for which you are retrieving renewal decisions
"2613a221-d3c8-4c8a-86d5-e7e885fd1da9"
Query Parameters
Renewal date to filter by, exact match
"Sat, 02 Jan 2021 00:00:00 GMT"
Filter request by renewal date starting from date provided
"Mon, 01 Jan 2024 00:00:00 GMT"
Filter request by renewal date up to date provided
"Mon, 01 Jan 2024 00:00:00 GMT"
Response
Successful Response - Returns the found renewal decisions.
Metadata associated with the response data
Show child attributes
Show child attributes
The offset of the first response record within the matching data set
x >= 0The page number of the response records within the overall data set (1-based integer)
x >= 1The maximum number of response records on each page of results
x >= 1The total number of records in the entire matching data set
x >= 0List of renewal decisions
Show child attributes
Show child attributes
The carrier and coverage expectations for the open enrollment period
Show child attributes
Show child attributes
Carrier-specific open enrollment information
1Show child attributes
Show child attributes
Unique identifier of the carrier in Noyo
Expected open enrollment information for each line of coverage
Show child attributes
Show child attributes
Open enrollment information relating to accident plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to accident plans
1Open enrollment information relating to AD&D plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to ADD plans
1Open enrollment information relating to cancer plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to cancer plans
1Open enrollment information relating to critical illness plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to critical illness plans
1Open enrollment information relating to dental plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to dental plans
1Open enrollment information relating to health fund plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to health fund plans
1Open enrollment information relating to hospital indemnity plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to hospital indemnity plans
1Open enrollment information relating to life plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to life plans
1Open enrollment information relating to LTD plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to LTD plans
1Open enrollment information relating to medical plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to medical plans
1Open enrollment information relating to pharmacy plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to pharmacy plans
1Open enrollment information relating to STD plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to STD plans
1Open enrollment information relating to vision plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to vision plans
1Open enrollment information relating to wellness plans
Show child attributes
Show child attributes
ISO-8601 date string for the end of the open enrollment period when member requests and changes can be processed
"2022-02-01"
ISO-8601 date string for the start of the open enrollment period when member requests and changes can be processed
"2022-01-01"
Open enrollment information related to wellness plans
1The date the record was created
Unique identifier of the group in Noyo
Unique identifier of the record in Noyo
List of any issues that explain why the open enrollment is 'not_ready'. Will be empty if it is status 'ready' or 'submitted'.
Show child attributes
Show child attributes
The level or severity of the issue found
warning, error Message describing the issue found and any steps to resolve
Unique identifier of the associated carrier in Noyo
Line of coverage related to the issue
The date the record was last updated
The start date for the new enrollment year when all coverage changes and decisions should become active
Calculated status based on whether or not the carrier system matches the expected renewal decisions
submitted, not_ready, ready, done Current version of the record
Was this page helpful?