> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsolum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve specialties

> Resolves specialties for one of your active policies exactly as creating a VOB would — each omitted field taken from your company's defaults, the billing credential from the policy's current verification (else its open VOB's result), then the insurance's billing default, then the credential registered for the specialty — and creates nothing. Omit `specialties` to get the ones Solum requests automatically for the policy. Use it to prefill a request before creating or editing it. 422 with the same body as a create's when the policy is not an active policy of your company or a field can't be resolved.



## OpenAPI

````yaml https://api.getsolum.com/openapi.json post /v1/verification-of-benefits/resolve
openapi: 3.1.0
info:
  title: Solum Health API
  description: '## Solum Health Backend API '
  version: 1.0.0
servers: []
security: []
paths:
  /v1/verification-of-benefits/resolve:
    post:
      tags:
        - Verification of Benefits
      summary: Resolve specialties
      description: >-
        Resolves specialties for one of your active policies exactly as creating
        a VOB would — each omitted field taken from your company's defaults, the
        billing credential from the policy's current verification (else its open
        VOB's result), then the insurance's billing default, then the credential
        registered for the specialty — and creates nothing. Omit `specialties`
        to get the ones Solum requests automatically for the policy. Use it to
        prefill a request before creating or editing it. 422 with the same body
        as a create's when the policy is not an active policy of your company or
        a field can't be resolved.
      operationId: resolve_vob_specialties_v1_verification_of_benefits_resolve_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VobResolve'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VobResolved'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: validation_error
                  code:
                    type: string
                    example: invalid_parameter
                  message:
                    type: string
                    example: Field validation failed
                  param:
                    type: string
                    example: phone_number
                required:
                  - type
                  - code
                  - message
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    VobResolve:
      properties:
        patient_policy_id:
          type: string
          title: Patient Policy Id
          description: The active policy the specialties are for.
        specialties:
          anyOf:
            - items:
                $ref: '#/components/schemas/SpecialtyIn'
              type: array
              minItems: 1
            - type: 'null'
          title: Specialties
          description: >-
            The specialties to resolve, as a create would take them. Omitted:
            the service types Solum requests for this policy when a patient
            enters a verification stage (your state and company configuration,
            then the policy's latest result, then the patient's referrals), each
            resolved from your defaults; none configured returns an empty list.
      additionalProperties: false
      type: object
      required:
        - patient_policy_id
      title: VobResolve
      description: Resolve a policy's specialties the way a create would, writing nothing.
    VobResolved:
      properties:
        patient_policy_id:
          type: string
          title: Patient Policy Id
        specialties:
          items:
            $ref: '#/components/schemas/ResolvedSpecialtyOut'
          type: array
          title: Specialties
      additionalProperties: false
      type: object
      required:
        - patient_policy_id
        - specialties
      title: VobResolved
      description: The resolved specialties of `VobResolve`.
    SpecialtyIn:
      properties:
        service_type:
          $ref: '#/components/schemas/ServiceType'
          description: The specialty to verify.
        credentialing_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Credentialing Id
          description: >-
            An active credentialing record of your company to bill under.
            Omitted: the policy's billing credential, else the insurance's
            billing default, else the credential registered for this specialty.
        cpt_codes:
          anyOf:
            - items:
                type: string
              type: array
              maxItems: 50
            - type: 'null'
          title: Cpt Codes
          description: >-
            Up to 50 CPT/HCPCS codes, five letters or digits each (trimmed,
            upper-cased, de-duplicated). Omitted: the company's default CPT
            codes for this specialty. The eligibility check asks the payer about
            the first 8.
        service_locations:
          anyOf:
            - items:
                $ref: '#/components/schemas/ServiceLocation'
              type: array
            - type: 'null'
          title: Service Locations
          description: >-
            At least one place of service. Omitted: the company's places of
            service.
        icd_codes:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Icd Codes
          description: >-
            Diagnosis codes (may be empty). Omitted: the company's default ICD
            codes for this specialty.
      additionalProperties: false
      type: object
      required:
        - service_type
      title: SpecialtyIn
      description: |-
        One specialty (service type) the VOB asks Solum to verify.

        Only `service_type` is required. Omit any other field to take the
        company's default for that service type; a field that has no default is
        refused with 422 naming the specialty and the field
        (`param="specialties[0].cpt_codes"`). The NPI is always copied from the
        credential, never sent.
    ResolvedSpecialtyOut:
      properties:
        service_type:
          $ref: '#/components/schemas/ServiceType'
        credentialing_id:
          type: string
          title: Credentialing Id
        npi:
          type: string
          title: Npi
        cpt_codes:
          items:
            type: string
          type: array
          title: Cpt Codes
        service_locations:
          items:
            $ref: '#/components/schemas/ServiceLocation'
          type: array
          title: Service Locations
        icd_codes:
          items:
            type: string
          type: array
          title: Icd Codes
        credentialing:
          anyOf:
            - $ref: '#/components/schemas/VobRequestServiceCredentialing'
            - type: 'null'
      type: object
      required:
        - service_type
        - credentialing_id
        - npi
        - cpt_codes
        - service_locations
        - icd_codes
      title: ResolvedSpecialtyOut
      description: 'One specialty as a create would store it: every field resolved.'
    ServiceType:
      type: string
      enum:
        - medical_care
        - surgical
        - consultation
        - diagnostic_x_ray
        - diagnostic_lab
        - radiation_therapy
        - anesthesia
        - surgical_assistance
        - other_medical
        - blood_charges
        - used_durable_medical_equipment
        - durable_medical_equipment_purchase
        - ambulatory_service_center_facility
        - renal_supplies_in_home
        - alternate_method_dialysis
        - chronic_renal_disease_equipment
        - pre_admission_testing
        - durable_medical_equipment_rental
        - pneumonia_vaccine
        - second_surgical_opinion
        - third_surgical_opinion
        - social_work
        - diagnostic_dental
        - periodontics
        - restorative
        - endodontics
        - maxillofacial_prosthetics
        - adjunctive_dental_services
        - health_benefit_plan_coverage
        - plan_waiting_period
        - chiropractic
        - chiropractic_office_visits
        - dental_care
        - dental_crowns
        - dental_accident
        - orthodontics
        - prosthodontics
        - oral_surgery
        - routine_preventive_dental
        - home_health_care
        - home_health_prescriptions
        - home_health_visits
        - hospice
        - respite_care
        - hospital
        - hospital_inpatient
        - hospital_room_and_board
        - hospital_outpatient
        - hospital_emergency_accident
        - hospital_emergency_medical
        - hospital_ambulatory_surgical
        - long_term_care
        - major_medical
        - medically_related_transportation
        - air_transportation
        - cabulance
        - licensed_ambulance
        - general_benefits
        - in_vitro_fertilization
        - mri_cat_scan
        - donor_procedures
        - acupuncture
        - newborn_care
        - pathology
        - smoking_cessation
        - well_baby_care
        - maternity
        - transplants
        - audiology_exam
        - inhalation_therapy
        - diagnostic_medical
        - private_duty_nursing
        - prosthetic_device
        - dialysis
        - otological_exam
        - chemotherapy
        - allergy_testing
        - immunizations
        - routine_physical
        - family_planning
        - infertility
        - abortion
        - aids
        - emergency_services
        - cancer
        - pharmacy
        - free_standing_prescription_drug
        - mail_order_prescription_drug
        - brand_name_prescription_drug
        - generic_prescription_drug
        - podiatry
        - podiatry_office_visits
        - podiatry_nursing_home_visits
        - professional_physician
        - anesthesiologist
        - professional_visit_office
        - professional_visit_inpatient
        - professional_visit_outpatient
        - professional_visit_nursing_home
        - professional_visit_skilled_nursing_facility
        - professional_visit_home
        - psychiatric
        - psychiatric_room_and_board
        - psychotherapy
        - psychiatric_inpatient
        - psychiatric_outpatient
        - rehabilitation
        - rehabilitation_room_and_board
        - rehabilitation_inpatient
        - rehabilitation_outpatient
        - occupational_therapy
        - physical_medicine
        - speech_therapy
        - skilled_nursing_care
        - skilled_nursing_care_room_and_board
        - substance_abuse
        - alcoholism
        - drug_addiction
        - vision_optometry
        - frames
        - routine_exam
        - lenses
        - nonmedically_necessary_physical
        - experimental_drug_therapy
        - burn_care
        - brand_name_prescription_drug_formulary
        - brand_name_prescription_drug_non_formulary
        - independent_medical_evaluation
        - partial_hospitalization_psychiatric
        - day_care_psychiatric
        - cognitive_therapy
        - massage_therapy
        - pulmonary_rehabilitation
        - cardiac_rehabilitation
        - pediatric
        - nursery
        - skin
        - orthopedic
        - cardiac
        - lymphatic
        - gastrointestinal
        - endocrine
        - neurology
        - eye
        - invasive_procedures
        - gynecological
        - obstetrical
        - obstetrical_gynecological
        - mail_order_prescription_drug_brand_name
        - mail_order_prescription_drug_generic
        - physician_visit_office_sick
        - physician_visit_office_well
        - coronary_care
        - private_duty_nursing_inpatient
        - private_duty_nursing_home
        - surgical_benefits_professional
        - surgical_benefits_facility
        - mental_health_provider_inpatient
        - mental_health_provider_outpatient
        - mental_health_facility_inpatient
        - mental_health_facility_outpatient
        - substance_abuse_facility_inpatient
        - substance_abuse_facility_outpatient
        - screening_x_ray
        - screening_laboratory
        - mammogram_high_risk_patient
        - mammogram_low_risk_patient
        - flu_vaccination
        - eyewear_and_accessories
        - case_management
        - dermatology
        - durable_medical_equipment
        - diabetic_supplies
        - generic_prescription_drug_formulary
        - generic_prescription_drug_non_formulary
        - allergy
        - intensive_care
        - mental_health
        - neonatal_intensive_care
        - oncology
        - physical_therapy
        - pulmonary
        - renal
        - residential_psychiatric_treatment
        - transitional_care
        - transitional_nursery_care
        - urgent_care
      title: ServiceType
      description: |-
        X12 Service Type — human-readable enum values stored in the database.
        See app/utils/service_type_mapping.py for code-to-type mappings.
    ServiceLocation:
      type: string
      enum:
        - home
        - office
        - school
        - daycare
        - community
        - telehealth
        - on_campus_outpatient_hospital
      title: ServiceLocation
      description: Service location enum matching Prisma @@map("service_location").
    VobRequestServiceCredentialing:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        type:
          type: string
          title: Type
        is_active:
          type: boolean
          title: Is Active
      type: object
      required:
        - id
        - name
        - type
        - is_active
      title: VobRequestServiceCredentialing
      description: Denormalised credentialing summary embedded in a VOB specialty.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````