This guide walks through submitting a member enrollment snapshot and polling for results.
1. Submit a Snapshot
POST an array of member snapshot objects to /api-integrations/ichrax/v1/member-snapshots. Each object represents one employee and their enrollment.
[ { "company" : { "partner_company_id" : "COMP-001" , "name" : "Example Company" , "tin" : "12-3456789" }, "enrollment_action" : "new_enrollment" , "employee" : { "person" : { "partner_individual_id" : "EMP-001" , "first_name" : "Jane" , "last_name" : "Smith" , "date_of_birth" : "1985-03-15" , "sex" : "F" , "ssn" : "123-45-6789" , "home_address" : { "street_one" : "123 Main St" , "city" : "Springfield" , "state" : "IL" , "zip_code" : "62701" , "county_fips_id" : "17167" }, "mailing_address" : { "street_one" : "123 Main St" , "city" : "Springfield" , "state" : "IL" , "zip_code" : "62701" , "county_fips_id" : "17167" } }, "employment" : { "employment_status" : "full-time" , "employment_dates" : { "hire_date" : "2020-06-01" } } }, "coverage" : { "carrier_id" : "anthem" , "plan_hios_id" : "12345IL0010001-01" , "plan_type" : "ppo" , "coverage_members" : [ { "partner_individual_id" : "EMP-001" , "action" : "enroll" , "effective_start_date" : "2026-01-01" , "effective_end_date" : "2026-12-31" } ] }, "events" : [ { "id" : "EVT-001" , "type" : "coverage" , "date" : "2026-01-01" , "reason" : "open_enrollment" } ] } ]
A successful 202 Accepted response returns a snapshot_id for polling:
{ "snapshot_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" , "items" : [] }
2. Poll for Status
GET /api-integrations/ichrax/v1/member-snapshots/{snapshot_id} until processing completes:
GET /api-integrations/ichrax/v1/member-snapshots/a1b2c3d4-e5f6-7890-abcd-ef1234567890 x-api-key: your-api-key-here
The response includes a top-level status and per-member results in body:
{ "snapshot_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" , "status" : "completed" , "body" : [ { "partner_individual_id" : "EMP-001" , "code" : 200 , "messages" : [] } ] }
Poll until status is no longer pending or processing. A completed status does not guarantee all members succeeded — always check individual code values.
Per-Member Status Codes
Code Meaning 200Member processed successfully 207Partial success — review messages 400Validation failure — member not submitted 500Internal error processing this member
Adding Dependents
Include a dependents array alongside the employee. Dependents must also be listed in coverage_members within the coverage record.
{ "company" : { "partner_company_id" : "COMP-001" , "name" : "Example Company" , "tin" : "12-3456789" }, "employee" : { "..." }, "dependents" : [ { "relationship" : "spouse" , "person" : { "partner_individual_id" : "DEP-001" , "first_name" : "John" , "last_name" : "Smith" , "date_of_birth" : "1983-07-22" , "sex" : "M" , "home_address" : { "..." }, "mailing_address" : { "..." } } } ], "coverage" : { "carrier_id" : "anthem" , "plan_hios_id" : "12345IL0010001-01" , "coverage_members" : [ { "partner_individual_id" : "EMP-001" , "action" : "enroll" , "effective_start_date" : "2026-01-01" , "effective_end_date" : "2026-12-31" }, { "partner_individual_id" : "DEP-001" , "action" : "enroll" , "effective_start_date" : "2026-01-01" , "effective_end_date" : "2026-12-31" } ] } }
Anthem-Specific Configuration
For Anthem plans, pass an AnthemVendorInboundContext object in carrier_specific_config:
{ "coverage" : { "carrier_id" : "anthem" , "plan_hios_id" : "12345IL0010001-01" , "carrier_specific_config" : { "electronic_communication_consent" : true , "establish_hsa" : false , "current_coverage_is_anthem" : false , "pediatric_dental_purchased" : false }, "coverage_members" : [ "..." ] } }
Full Enrollment Example
A complete new_enrollment snapshot exercising every optional section — person contact and details, employment, PCP and prior coverage, agent, agency, payment, and carrier-specific config. coverage_members[].event_id references an entry in the top-level events array.
[ { "company" : { "partner_company_id" : "acme-corp" , "name" : "Acme Corp" , "tin" : "1234" }, "enrollment_action" : "new_enrollment" , "employee" : { "person" : { "partner_individual_id" : "7741052" , "first_name" : "Jane" , "last_name" : "Smith" , "date_of_birth" : "1987-04-19" , "sex" : "F" , "ssn" : "123-45-6789" , "marital_status" : "domestic-partner" , "home_address" : { "street_one" : "345 Sample Street" , "city" : "Indianapolis" , "state" : "IN" , "zip_code" : "46203" , "county_fips_id" : "18097" }, "mailing_address" : { "street_one" : "345 Sample Street" , "city" : "Indianapolis" , "state" : "IN" , "zip_code" : "46203" , "county_fips_id" : "18097" }, "contact" : { "email" : "[email protected] " , "phone" : "3175550148" , "preferred_language" : "en" , "preferred_method" : "EMAIL" }, "details" : { "tobacco" : { "user" : false } } }, "employment" : { "employment_status" : "full-time" , "employment_dates" : { "hire_date" : "2025-01-01" } } }, "coverage" : { "carrier_id" : "17575" , "plan_hios_id" : "17575IN0990010" , "carrier_plan_id" : "8XTB" , "plan_type" : "hmo" , "carrier_specific_config" : { "agent_tin" : "QWPLZMNTRB" , "agency_tin" : "VXRDFHJKLP" , "is_agent_assisted" : true , "electronic_communication_consent" : true , "establish_hsa" : false , "current_coverage_is_anthem" : false , "is_agree_to_electronic_signature" : true , "is_read_completed_app" : true , "is_agree_to_mem_communication" : true , "is_read_understand_enroll_form" : true , "have_disabled_dependent" : false , "pediatric_dental_purchased" : false , "members" : [ { "partner_individual_id" : "7741052" , "is_legal_resident" : true , "is_incarcerated" : false , "is_medicare_eligible" : false , "is_medicare_enrolled" : false , "is_medicaid_enrolled" : false } ] }, "coverage_members" : [ { "partner_individual_id" : "7741052" , "action" : "enroll" , "effective_start_date" : "2026-07-01" , "effective_end_date" : "2026-12-31" , "event_id" : "ichra-effective" , "pcp_details" : { "npi" : "1538291746" }, "prior_coverage" : { "coverage_end_date" : "2026-03-31" , "term_with_new_policy" : true } } ], "agent" : { "first_name" : "Robert" , "last_name" : "Hartley" , "phone" : "8035550172" , "email_address" : "[email protected] " , "address" : { "street_one" : "76 Harbor Rd" , "city" : "Columbia" , "state" : "SC" , "zip_code" : "29201" } }, "agency" : { "name" : "Hartley Benefits Group" , "tin" : "VXRDFHJKLP" , "email" : "[email protected] " , "address" : { "street_one" : "76 Harbor Rd" , "city" : "Columbia" , "state" : "SC" , "zip_code" : "29201" } }, "payment" : { "monthly_premium" : 713.72 , "billing_address" : { "street_one" : "440 Oak Hollow Dr" , "city" : "Dublin" , "state" : "OH" , "zip_code" : "43017" }, "credit_card" : { "card_type" : "VISA" , "card_holder_name" : "Jane Smith" , "card_number" : "4111111111111111" , "expiration_date" : "06/2031" , "security_code" : "417" } } }, "events" : [ { "id" : "ichra-effective" , "type" : "coverage" , "date" : "2026-06-01" , "reason" : "new_hire" } ] } ]
Last modified on July 9, 2026