Get Renewal Decisions

GET

api

renewal_decisions

curl --request GET \
  --url https://fulfillment.noyo.com/api/v1/renewal_decisions

{
  "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"
                  }
                ]
              },
              "medical": {
                "open_enrollment_end_date": "2022-01-31",
                "open_enrollment_start_date": "2022-01-01",
                "plans": [
                  {
                    "plan_id": "818e52d4-6c34-4914-b716-a3047c85e468"
                  },
                  {
                    "plan_id": "f9897240-87f8-4d9d-a68f-58bc445fe0b2"
                  },
                  {
                    "name": "Select Plus PPO HDHP Bronze BRJJ /C38"
                  }
                ]
              }
            }
          }
        ]
      },
      "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"
    }
  ]
}

Query Parameters

group_name

string

Group name to filter by, exact match

status

string

Status to filter by, exact match

start_date

string

Filter request by renewal date starting from date provided

end_date

string

Filter request by renewal date up to date provided

Response

200 - application/json

Successful Response - Returns the found renewal decisions.

meta

object

required

Metadata associated with the response data

response

object[]

required

List of renewal decisions

response.body

object

required

The carrier and coverage expectations for the open enrollment period

response.created

integer

required

The date the record was created

response.group_id

string

required

Unique identifier of the group in Noyo

response.id

string

required

Unique identifier of the record in Noyo

response.issues

object[]

required

List of any issues that explain why the open enrollment is 'not_ready'. Will be empty if it is status 'ready' or 'submitted'.

response.modified

integer

required

The date the record was last updated

response.renewal_date

string

required

The start date for the new enrollment year when all coverage changes and decisions should become active

response.status

enum<string>

required

Calculated status based on whether or not the carrier system matches the expected renewal decisions

Available options:

submitted,

not_ready,

ready,

done

response.version

string

required

Current version of the record

Was this page helpful?

List Group Plans Get Renewal Decisions by Group

curl --request GET \
  --url https://fulfillment.noyo.com/api/v1/renewal_decisions

{
  "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"
                  }
                ]
              },
              "medical": {
                "open_enrollment_end_date": "2022-01-31",
                "open_enrollment_start_date": "2022-01-01",
                "plans": [
                  {
                    "plan_id": "818e52d4-6c34-4914-b716-a3047c85e468"
                  },
                  {
                    "plan_id": "f9897240-87f8-4d9d-a68f-58bc445fe0b2"
                  },
                  {
                    "name": "Select Plus PPO HDHP Bronze BRJJ /C38"
                  }
                ]
              }
            }
          }
        ]
      },
      "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"
    }
  ]
}

Groups

Members

Changes

Legacy

Get Renewal Decisions

Query Parameters

Response