### POST /providers/search Example Source: https://ideonapi.gitbook.io/quote-and-select/provider-network-directory-search/search-for-a-specific-provider/configuring-search-requests Example request to the Provider Search endpoint demonstrating recommended search criteria including provider name, geography, type, and insurance acceptance. ```json { "provider_name_search": "Smith", "zip_code": "10010", "radius": 10, "type": "individual", "accepts_insurance": true } ``` -------------------------------- ### Querying Documentation via GET Request Source: https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8/create-a-group To get additional information not directly on the page, perform an HTTP GET request to the current page URL with the 'ask' query parameter. The question should be specific and self-contained. ```http GET https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8/create-a-group.md?ask= ``` -------------------------------- ### Querying Documentation with GET Request Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/zip-counties To get additional information not directly on the page, perform an HTTP GET request to the page URL with the 'ask' query parameter. The question should be specific and in natural language. ```http GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/zip-counties.md?ask= ``` -------------------------------- ### POST /groups Request Example (v8) Source: https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8/create-a-group This example demonstrates a valid request body for creating a group using the v8 schema, including all required fields for Small Group Quoting. ```json { "group": { "agency_name": "Agency Name", "agency_npn": "123456789", "broker_email": "broker@email.com", "broker_name": "Broker Name", "broker_npn": "123456789", "company_name": "Internal Test Group", "company_tax_id": "123456789", "external_id": "abc123", "sic_code": "5411" }, "locations": [ { "zip_code": "10010", "fips_code": "36061", "name": "Headquarters", "number_of_employees": 10, "primary": true } ] } ``` -------------------------------- ### Example Partitioned manifest.json Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/select-provider-network-data This JSON structure shows multiple provider files when partitioning is enabled. The `file_urls` array lists all available files for download. ```json { "file_urls": [ "s3://bulk-data.vericred.com/networks/{username}/{run_id}/metadata.json", "s3://bulk-data.vericred.com/networks/{username}/{run_id}/providers_1.jsonl.gz", "s3://bulk-data.vericred.com/networks/{username}/{run_id}/providers_2.jsonl.gz" ] } ``` -------------------------------- ### Example manifest.json Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/select-provider-network-data This JSON structure indicates the metadata and provider files available for download. It is the source of truth for identifying the latest files. ```json { "bulk_run_id": 1234, "run_date": "2026-01-01", "file_urls": [ "s3://bulk-data.vericred.com/networks/{username}/1234/metadata.json", "s3://bulk-data.vericred.com/networks/{username}/1234/providers.jsonl.gz" ] } ``` -------------------------------- ### Query Documentation with GET Request Source: https://ideonapi.gitbook.io/quote-and-select/postman-collections Perform an HTTP GET request on a page URL with the 'ask' query parameter to dynamically query documentation. The question should be specific and self-contained. ```http GET https://ideonapi.gitbook.io/quote-and-select/postman-collections.md?ask= ``` -------------------------------- ### Minimum Participation Percentage Rule Example Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/quote-plan-and-rate-data Example of a business rule specifying the minimum enrollment percentage of eligible members for group eligibility. ```json { "minimum_percentage": 50 } ``` -------------------------------- ### Querying Documentation via GET Request Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plan-network-mapping Use this mechanism to query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter. ```http GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plan-network-mapping.md?ask= ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8 To get additional information not directly present on a page, perform an HTTP GET request with the `ask` query parameter. The question should be specific and self-contained. ```http GET https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8.md?ask= ``` -------------------------------- ### Dental Plan Benefit Example Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/benefit-grammar-guides/dental Example of a dental plan benefit for 'restoration_fillings', showing in-network and out-of-network cost shares, and a coverage tier. ```json "restoration_fillings": { "in_network": "10%", "out_of_network": "20%", "limit": "1 treatment(s) per 1 tooth per 2 year(s)", "coverage_tier": "basic" } ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/api-basics To get information not directly present on a page, make a GET request to the page URL with an 'ask' query parameter. The response will include a direct answer and relevant excerpts. ```http GET https://ideonapi.gitbook.io/quote-and-select/api-basics.md?ask= ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api To get additional information not directly present on a page, perform an HTTP GET request with the 'ask' query parameter. The question should be specific and in natural language. ```HTTP GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api.md?ask= ``` -------------------------------- ### Query Documentation with 'ask' Parameter Source: https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8/add-a-census To get additional information not directly on the page, perform an HTTP GET request to the page URL with the 'ask' query parameter. This allows for dynamic querying of the documentation. ```http GET https://ideonapi.gitbook.io/quote-and-select/previous-versions/group-quoting-v8/add-a-census.md?ask= ``` -------------------------------- ### POST /plans/bulk Request Example Source: https://ideonapi.gitbook.io/quote-and-select/quote-individuals/aca-medical/cache-benefits Example request to retrieve paginated results for Individual Medical plans for a specific plan year and state. It's recommended to request 100 items per page for performance optimization. ```json { "state": "CA", "year": "2025", "market": "individual", "product_line": "medical" } ``` -------------------------------- ### GET /quotes//rates Response with Quote Exceptions Source: https://ideonapi.gitbook.io/quote-and-select/quote-groups/small-group-medical/retrieve-premium-and-eligibility-results This JSON snippet illustrates the structure of the 'quote_exceptions' array within the Display Rates response. It shows examples of exceptions flagged by Ideon's business rules and those originating from a carrier API. ```json { "rates": [ { // Plan identifiers, // rates array, "quote_exceptions": [ { "code": "in_state_percentage_minimum", "source": "ideon_business_rules", "quote_impacted": false, "message": "..." }, { "code": "carrier_api_error", "source": "carrier_api", "quote_impacted": true, "message": "...", "carrier_api_error_messages": [ "...." ] } ] // member_exceptions array (if applicable) } ] } ``` -------------------------------- ### Manifest File Example for Bulk File Partitioning Source: https://ideonapi.gitbook.io/quote-and-select/product-release-notes/q1-2026 This JSON structure represents a manifest file that lists the individual data files available for download when Bulk File Partitioning is enabled. ```json { "files": [ "s3://bulk-data.vericred.com/networks/{username}/{run_id}/providers_1.jsonl.gz", "s3://bulk-data.vericred.com/networks/{username}/{run_id}/providers_2.jsonl.gz" ] } ``` -------------------------------- ### Query Documentation via HTTP GET Source: https://ideonapi.gitbook.io/quote-and-select/quote-groups/level-funded/unitedhealthcare Use this method to ask questions about the documentation dynamically. The response includes direct answers and relevant excerpts. ```http GET https://ideonapi.gitbook.io/quote-and-select/quote-groups/level-funded/unitedhealthcare.md?ask= ``` -------------------------------- ### Tobacco Cutoff Rule Example Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/quote-plan-and-rate-data Example of a business rule specifying the lookback period for tobacco use assessment. ```json { "months": 6 } ``` -------------------------------- ### Maximum Age Dependent Rule Example Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/quote-plan-and-rate-data Example of a business rule defining the maximum age for child dependents. ```json { "age": 26 } ``` -------------------------------- ### Eligible Children Cap Rule Example Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/quote-plan-and-rate-data Example of a business rule setting a cap on the number of eligible child dependents for premium quoting. ```json { "max_age_of_child": 20, "eligible_children_cap": 3 } ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/carrier-inventory-and-search Use this method to ask questions about the documentation. The response includes direct answers and relevant excerpts. ```HTTP GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/carrier-inventory-and-search.md?ask= ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/quote-individuals/aca-medical/quote-applicants/subsidies-and-tax-credits Use this GET request to query the documentation dynamically with a specific question. The response will include a direct answer and relevant excerpts. ```http GET https://ideonapi.gitbook.io/quote-and-select/quote-individuals/aca-medical/quote-applicants/subsidies-and-tax-credits.md?ask= ``` -------------------------------- ### Query Documentation via HTTP GET Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plans Use this method to ask specific questions about the documentation. The response includes direct answers and relevant excerpts. ```http GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plans.md?ask= ``` -------------------------------- ### Members In Service Area Rule Example Source: https://ideonapi.gitbook.io/quote-and-select/flat-file-data-dictionaries/quote-plan-and-rate-data Example of a business rule indicating that members must reside in the plan's service area to be eligible. ```json { "required?": true } ``` -------------------------------- ### Specialist Benefit Example Source: https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/benefit-grammar-guides/medical Example of how a specialist benefit might be presented, including in-network, out-of-network, and tier-specific cost shares, as well as visit limitations. ```json "specialist": { "in_network": "$40", "in_network_tier_2": "10% after deductible", "out_of_network": "30% after deductible", "limit": "20 visit(s) per year" } ``` -------------------------------- ### Querying Documentation with 'ask' Parameter Source: https://ideonapi.gitbook.io/quote-and-select/provider-network-directory-search/search-for-a-specific-provider To get additional information not directly on the page, perform an HTTP GET request with the 'ask' query parameter. The question should be specific and self-contained. ```HTTP GET https://ideonapi.gitbook.io/quote-and-select/provider-network-directory-search/search-for-a-specific-provider.md?ask= ``` -------------------------------- ### Query Documentation Dynamically Source: https://ideonapi.gitbook.io/quote-and-select/provider-network-directory-search/other-workflows/evaluate-many-providers-across-networks Use this method to ask questions about the documentation and receive direct answers with relevant excerpts. The question should be specific and in natural language. ```HTTP GET https://ideonapi.gitbook.io/quote-and-select/provider-network-directory-search/other-workflows/evaluate-many-providers-across-networks.md?ask= ```