A Group represents a collection of members - frequently a single employer group.\

Endpoint

https://platform.wellviasolutions.com/organization/v1/group\

The Group Object

Attributes

idstring:required

The unique identifier of the group.

clientIdstring:required

The unique identifier of the client that the group belongs to.

namestring:required

The displayed name of the group.

serviceOfferingslist of objects:required

A list of the different service offerings the group has access to.

idstring:required

The unique identifier of the service offering.

planDesignslist of objects:required

A list of the different services included and their respective pricing and configurations.

visitTypestring:required

The unique type identifier specifying the type of visit. See the Visit Type Dictionary for possible values.

requireRTELookupboolean:required

Specifies if a real-time eligibility lookup (EDI 270) is required when the member requests this service.

applyDeductibleLogicboolean:required

Specifies if the member's deductible is to be taken into consideration for the visit fee.

applyCoInsuranceLogicboolean:required

Specifies if the member's co-insurance is to be taken into consideration for the visit fee.

memberFeedecimal:optional

The amount to be paid by the member before any additional discounts, deductibles, or other considerations are taken into account. This should be considered as a "default" fee.

memberFeeBeforeDeductibleMetdecimal:optional

The amount to be paid by the member before their deductible has been met.

memberFeeAfterDeductibleMetdecimal:optional

The amount to be paid by the patient after their deductible has been met.

thirdPartyFeeBeforeDeductibleMetdecimal:optional

The amount to be paid by the payer (or other responsible party) before the members' deductible has been met.

thirdPartyFeeAfterDeductibleMetdecimal:optional

The amount to be paid by the payer (or other responsible party) after the members' deductible has been met.

totalFeedecimal:optional

The total amount to be billed for this visit type.

billingAmountdecimal:required

The access fee to be paid for this service offering at the frequency of the billingCycle.

billingCyclestring:required

The frequency in which the sponsor will be billed the billingAmount. See the Billing Cycle Type Dictionary for possible values.

alternativeIdsdictionary:required

A dictionary containing alternative identifiers for this service offering.

keystring:required

A unique value that represents the service offering. This is frequently a known value to the client and can be used to identify the required id for other API requests.

valuestring:required

A value that represents the service offering identifier type. See the Service Offering Identifier Type Dictionary for possible values.

isEnabledboolean:required

Specifies if the group is active and members have access to services.

alternativeIdslist of strings:required

Additional unique alternative identifiers for the group.

startDatetimestamp:optional

The date the group is activated for service.

endDatetimestamp:optional

The date the group is termed from service.

alternativeTreatmentMethodCostdictionary:required

The alternative treatment cost of services for this group.

keystring:required

The unique type of alternative treatment. See the Service Offering Identifier Type Dictionary for possible values.

valuedecimal:required

The dollar amount representing the typical cost of treatment.

fulfillmentobject:required

An object containing details around email and hard-copy fulfillment for the group.

emailFulfillmentboolean:required

Specifies if welcome emails are sent out to new members when they are created.

hardCopyFulfillmentboolean:required

Specifies if ID cards are mailed to new members when they are created.

Example

{
	"id": "94534",
	"clientId": "123456",
	"name": "Todd's Tacos",
	"serviceOfferings": [
		{
			"id": "123",
			"planDesigns": [
				{
					"visitType": "generalmedical",
					"requireRTELookup": false,
					"applyDeductibleLogic": false,
					"applyCoInsuranceLogic": true,
					"memberFee": 0.00,
					"memberFeeBeforeDeductibleMet": null,
					"memberFeeAfterDeductibleMet": null,
					"thirdPartyFeeBeforeDeductibleMet": null,
					"thirdPartyFeeAfterDeductibleMet": null,
					"totalFee": null
				},
				{
					"visitType": "dermatologyinitial",
					"requireRTELookup": false,
					"applyDeductibleLogic": false,
					"applyCoInsuranceLogic": true,
					"memberFee": 0.00,
					"memberFeeBeforeDeductibleMet": null,
					"memberFeeAfterDeductibleMet": null,
					"thirdPartyFeeBeforeDeductibleMet": null,
					"thirdPartyFeeAfterDeductibleMet": null,
					"totalFee": null
				},
				{
					"visitType": "therapycounseling",
					"requireRTELookup": false,
					"applyDeductibleLogic": false,
					"applyCoInsuranceLogic": true,
					"memberFee": 0.00,
					"memberFeeBeforeDeductibleMet": null,
					"memberFeeAfterDeductibleMet": null,
					"thirdPartyFeeBeforeDeductibleMet": null,
					"thirdPartyFeeAfterDeductibleMet": null,
					"totalFee": null
				}
			],
			"billingAmount": 10.0000,
			"billingCycle": "monthly",
			"alternativeIds": {
				"A": "offeringcode",
				"1c2e2dce948c4350b8b1a1dea67f": "clientserviceofferingid"
			}
		},
		{
			"id": "456",
			"planDesigns": [
				{
					"visitType": "generalmedical",
					"requireRTELookup": false,
					"applyDeductibleLogic": false,
					"applyCoInsuranceLogic": true,
					"memberFee": 40.00,
					"memberFeeBeforeDeductibleMet": null,
					"memberFeeAfterDeductibleMet": null,
					"thirdPartyFeeBeforeDeductibleMet": null,
					"thirdPartyFeeAfterDeductibleMet": null,
					"totalFee": null
				}
			],
			"billingAmount": 5.0000,
			"billingCycle": "monthly",
			"alternativeIds": {
				"B": "offeringcode",
				"a16d7230ba3aadae629e99811de0": "clientserviceofferingid"
			}
		}
	],
	"isEnabled": true,
	"alternativeIds": [
		"TT01"
	],
	"startDate": "2022-05-27T00:00:00",
	"endDate": null,
	"alternativeTreatmentMethodCost": {
		"primarycare": 100.0000,
		"specialist": 130.0000,
		"emergencyroom": 1000.0000,
		"urgentcare": 155.0000
	},
	"fulfillment": {
		"emailFulfillment": false,
		"hardCopyFulfillment": false
	}
}