cURL
curl --request PATCH \
--url https://sandbox.withclasp.com/plans/{public_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"plan_name": "<string>",
"plan_type": "<string>",
"group": "<string>",
"is_low_cost": true,
"provides_minimum_value": true,
"provides_essential_coverage": true,
"dependent_coverage_excluded": true,
"spouse_coverage_excluded": true,
"plan_details": [
{
"label": "<string>",
"tooltip": "<string>",
"info_lines": [
"<string>"
]
}
],
"bundle": "<string>",
"hsa_eligible": false,
"allowed_employment_statuses": [
"full_time",
"part_time"
],
"union_eligible": true,
"seasonal_eligible": true,
"newly_available": true,
"partner_enrollment_required": true,
"child_enrollment_required": true,
"create_payroll_benefits": true,
"metadata": {}
}
'import requests
url = "https://sandbox.withclasp.com/plans/{public_id}"
payload = {
"plan_name": "<string>",
"plan_type": "<string>",
"group": "<string>",
"is_low_cost": True,
"provides_minimum_value": True,
"provides_essential_coverage": True,
"dependent_coverage_excluded": True,
"spouse_coverage_excluded": True,
"plan_details": [
{
"label": "<string>",
"tooltip": "<string>",
"info_lines": ["<string>"]
}
],
"bundle": "<string>",
"hsa_eligible": False,
"allowed_employment_statuses": ["full_time", "part_time"],
"union_eligible": True,
"seasonal_eligible": True,
"newly_available": True,
"partner_enrollment_required": True,
"child_enrollment_required": True,
"create_payroll_benefits": True,
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
plan_name: '<string>',
plan_type: '<string>',
group: '<string>',
is_low_cost: true,
provides_minimum_value: true,
provides_essential_coverage: true,
dependent_coverage_excluded: true,
spouse_coverage_excluded: true,
plan_details: [{label: '<string>', tooltip: '<string>', info_lines: ['<string>']}],
bundle: '<string>',
hsa_eligible: false,
allowed_employment_statuses: ['full_time', 'part_time'],
union_eligible: true,
seasonal_eligible: true,
newly_available: true,
partner_enrollment_required: true,
child_enrollment_required: true,
create_payroll_benefits: true,
metadata: {}
})
};
fetch('https://sandbox.withclasp.com/plans/{public_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.withclasp.com/plans/{public_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'plan_name' => '<string>',
'plan_type' => '<string>',
'group' => '<string>',
'is_low_cost' => true,
'provides_minimum_value' => true,
'provides_essential_coverage' => true,
'dependent_coverage_excluded' => true,
'spouse_coverage_excluded' => true,
'plan_details' => [
[
'label' => '<string>',
'tooltip' => '<string>',
'info_lines' => [
'<string>'
]
]
],
'bundle' => '<string>',
'hsa_eligible' => false,
'allowed_employment_statuses' => [
'full_time',
'part_time'
],
'union_eligible' => true,
'seasonal_eligible' => true,
'newly_available' => true,
'partner_enrollment_required' => true,
'child_enrollment_required' => true,
'create_payroll_benefits' => true,
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.withclasp.com/plans/{public_id}"
payload := strings.NewReader("{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://sandbox.withclasp.com/plans/{public_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.withclasp.com/plans/{public_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"plan_name": "<string>",
"plan_type": "<string>",
"line_of_coverage": "accident",
"group": "<string>",
"effective_start": "2023-12-25",
"effective_end": "2023-12-25",
"member_count": 123,
"dependent_count": 123,
"requires_primary_care_provider": true,
"plan_details": "<unknown>",
"plan_summary_url": "<string>",
"is_low_cost": true,
"provides_minimum_value": true,
"provides_essential_coverage": true,
"dependent_coverage_excluded": true,
"spouse_coverage_excluded": true,
"bundle": "<string>",
"premium_type": "composite",
"partner_dependents_eligible": true,
"child_dependents_eligible": true,
"voluntary_coverage_options": {},
"plan_configurations": [
"<string>"
],
"required_enrollment": true,
"hsa_eligible": true,
"is_pre_tax": true,
"cobra_eligible": true,
"max_contributing_children": 123,
"required_regions": [
"AL"
],
"minimum_hours_worked": 123,
"base_spouse_age_off_member": 123,
"age_calculation_method": "coverage_start_date",
"newly_available": true,
"allowed_employment_statuses": [
"full_time",
"part_time"
],
"union_eligible": true,
"seasonal_eligible": true,
"partner_enrollment_required": true,
"child_enrollment_required": true,
"create_payroll_benefits": true,
"metadata": {}
}Plans
Update Plan
Updates a plan’s details.
PATCH
/
plans
/
{public_id}
cURL
curl --request PATCH \
--url https://sandbox.withclasp.com/plans/{public_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"plan_name": "<string>",
"plan_type": "<string>",
"group": "<string>",
"is_low_cost": true,
"provides_minimum_value": true,
"provides_essential_coverage": true,
"dependent_coverage_excluded": true,
"spouse_coverage_excluded": true,
"plan_details": [
{
"label": "<string>",
"tooltip": "<string>",
"info_lines": [
"<string>"
]
}
],
"bundle": "<string>",
"hsa_eligible": false,
"allowed_employment_statuses": [
"full_time",
"part_time"
],
"union_eligible": true,
"seasonal_eligible": true,
"newly_available": true,
"partner_enrollment_required": true,
"child_enrollment_required": true,
"create_payroll_benefits": true,
"metadata": {}
}
'import requests
url = "https://sandbox.withclasp.com/plans/{public_id}"
payload = {
"plan_name": "<string>",
"plan_type": "<string>",
"group": "<string>",
"is_low_cost": True,
"provides_minimum_value": True,
"provides_essential_coverage": True,
"dependent_coverage_excluded": True,
"spouse_coverage_excluded": True,
"plan_details": [
{
"label": "<string>",
"tooltip": "<string>",
"info_lines": ["<string>"]
}
],
"bundle": "<string>",
"hsa_eligible": False,
"allowed_employment_statuses": ["full_time", "part_time"],
"union_eligible": True,
"seasonal_eligible": True,
"newly_available": True,
"partner_enrollment_required": True,
"child_enrollment_required": True,
"create_payroll_benefits": True,
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
plan_name: '<string>',
plan_type: '<string>',
group: '<string>',
is_low_cost: true,
provides_minimum_value: true,
provides_essential_coverage: true,
dependent_coverage_excluded: true,
spouse_coverage_excluded: true,
plan_details: [{label: '<string>', tooltip: '<string>', info_lines: ['<string>']}],
bundle: '<string>',
hsa_eligible: false,
allowed_employment_statuses: ['full_time', 'part_time'],
union_eligible: true,
seasonal_eligible: true,
newly_available: true,
partner_enrollment_required: true,
child_enrollment_required: true,
create_payroll_benefits: true,
metadata: {}
})
};
fetch('https://sandbox.withclasp.com/plans/{public_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.withclasp.com/plans/{public_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'plan_name' => '<string>',
'plan_type' => '<string>',
'group' => '<string>',
'is_low_cost' => true,
'provides_minimum_value' => true,
'provides_essential_coverage' => true,
'dependent_coverage_excluded' => true,
'spouse_coverage_excluded' => true,
'plan_details' => [
[
'label' => '<string>',
'tooltip' => '<string>',
'info_lines' => [
'<string>'
]
]
],
'bundle' => '<string>',
'hsa_eligible' => false,
'allowed_employment_statuses' => [
'full_time',
'part_time'
],
'union_eligible' => true,
'seasonal_eligible' => true,
'newly_available' => true,
'partner_enrollment_required' => true,
'child_enrollment_required' => true,
'create_payroll_benefits' => true,
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.withclasp.com/plans/{public_id}"
payload := strings.NewReader("{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://sandbox.withclasp.com/plans/{public_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.withclasp.com/plans/{public_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"plan_name\": \"<string>\",\n \"plan_type\": \"<string>\",\n \"group\": \"<string>\",\n \"is_low_cost\": true,\n \"provides_minimum_value\": true,\n \"provides_essential_coverage\": true,\n \"dependent_coverage_excluded\": true,\n \"spouse_coverage_excluded\": true,\n \"plan_details\": [\n {\n \"label\": \"<string>\",\n \"tooltip\": \"<string>\",\n \"info_lines\": [\n \"<string>\"\n ]\n }\n ],\n \"bundle\": \"<string>\",\n \"hsa_eligible\": false,\n \"allowed_employment_statuses\": [\n \"full_time\",\n \"part_time\"\n ],\n \"union_eligible\": true,\n \"seasonal_eligible\": true,\n \"newly_available\": true,\n \"partner_enrollment_required\": true,\n \"child_enrollment_required\": true,\n \"create_payroll_benefits\": true,\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"plan_name": "<string>",
"plan_type": "<string>",
"line_of_coverage": "accident",
"group": "<string>",
"effective_start": "2023-12-25",
"effective_end": "2023-12-25",
"member_count": 123,
"dependent_count": 123,
"requires_primary_care_provider": true,
"plan_details": "<unknown>",
"plan_summary_url": "<string>",
"is_low_cost": true,
"provides_minimum_value": true,
"provides_essential_coverage": true,
"dependent_coverage_excluded": true,
"spouse_coverage_excluded": true,
"bundle": "<string>",
"premium_type": "composite",
"partner_dependents_eligible": true,
"child_dependents_eligible": true,
"voluntary_coverage_options": {},
"plan_configurations": [
"<string>"
],
"required_enrollment": true,
"hsa_eligible": true,
"is_pre_tax": true,
"cobra_eligible": true,
"max_contributing_children": 123,
"required_regions": [
"AL"
],
"minimum_hours_worked": 123,
"base_spouse_age_off_member": 123,
"age_calculation_method": "coverage_start_date",
"newly_available": true,
"allowed_employment_statuses": [
"full_time",
"part_time"
],
"union_eligible": true,
"seasonal_eligible": true,
"partner_enrollment_required": true,
"child_enrollment_required": true,
"create_payroll_benefits": true,
"metadata": {}
}Authorizations
API Key authentication with required prefix "Bearer"
Path Parameters
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
High-level details of plan that is shown during enrollment.
Show child attributes
Show child attributes
Available options:
composite, age_banded, volume_based full_time- Full Timepart_time- Part Timevariable_hours- Variable Hours
Available options:
full_time, part_time, variable_hours Up to 50 key-value pairs. Keys max 40 characters, values max 500 characters. Set a value to empty string to remove a key. On PATCH, metadata is merged with existing values.
Show child attributes
Show child attributes
Response
200 - application/json
Pattern:
^[-a-zA-Z0-9_]+$accident- Accidentaccidental_death- Accidental Death and Dismembermentcancer- Cancercommuter_parking- Commuter Parkingcommuter_transit- Commuter Transitdental- Dentaldependent_care_fsa- Dependent Care Flexible Spending Accountemployee_assistance_program- Employee Assistance Programhealthcare_fsa- Healthcare Flexible Spending Accounthospital_indemnity- Hospital Indemnityhsa- Health Savings Accountlegal_services- Legal Serviceslife- Lifelimited_purpose_fsa- Limited Purpose Flexible Spending Accountlong_term_disability- Long Term Disabilitylump_sum_disability- Lump Sum Disabilitymedical- Medicalpet_insurance- Pet Insuranceshort_term_disability- Short Term Disabilitysupplemental- Supplementaltelemedicine- Telemedicinevision- Visionvoluntary_critical_illness- Voluntary Critical Illnessvoluntary_life- Voluntary Lifevoluntary_accidental_death- Voluntary Accidental Deathvoluntary_long_term_disability- Voluntary Long Term Disabilityvoluntary_ltd- Voluntary LTDvoluntary_short_term_disability- Voluntary Short Term Disability
Available options:
accident, accidental_death, cancer, commuter_parking, commuter_transit, dental, dependent_care_fsa, employee_assistance_program, healthcare_fsa, hospital_indemnity, hsa, legal_services, life, limited_purpose_fsa, long_term_disability, lump_sum_disability, medical, pet_insurance, short_term_disability, supplemental, telemedicine, vision, voluntary_critical_illness, voluntary_life, voluntary_accidental_death, voluntary_long_term_disability, voluntary_ltd, voluntary_short_term_disability Available options:
composite, age_banded, volume_based AL- ALAK- AKAZ- AZAR- ARCA- CACO- COCT- CTDE- DEDC- DCFL- FLGA- GAHI- HIID- IDIL- ILIN- INIA- IAKS- KSKY- KYLA- LAME- MEMD- MDMA- MAMI- MIMN- MNMS- MSMO- MOMT- MTNE- NENV- NVNH- NHNJ- NJNM- NMNY- NYNC- NCND- NDOH- OHOK- OKOR- ORPA- PARI- RISC- SCSD- SDTN- TNTX- TXUT- UTVT- VTVA- VAWA- WAWV- WVWI- WIWY- WY
Available options:
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY Available options:
coverage_start_date, plan_start_date full_time- Full Timepart_time- Part Timevariable_hours- Variable Hours
Available options:
full_time, part_time, variable_hours Up to 50 key-value pairs. Keys max 40 characters, values max 500 characters. Set a value to empty string to remove a key. On PATCH, metadata is merged with existing values.
Show child attributes
Show child attributes