# startVisionTest

**Type:** GraphQL mutations

**Description:**
Start a workflow utilizing one or more Visibly services

## Arguments
- contacts (ContactsInput): Optional prescribed and ordered contacts
  - products (ContactsProductsInput): undefined
    - right (ContactsProductInput): undefined
      - productId (String): ID that uniquely maps to a manufacturer, brand, and potentially other parameters
      - diameter (String): The width of the contact lens from edge to edge measured by millimeters
      - baseCurve (String): Indication of the curvature of the inside of the lens
      - sphere (String): The amount of lens power measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
      - axis (String): The lens meridian with no cylinder power, indicated by a value between 1 and 180 degrees
      - cylinder (String): The amount of lens power for astigmatism measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
      - addition (String): The additional magnifying power that applies to the bottom portion of multifocal lenses to fix presbyopia
      - dominance (String): Indication of dominant or non-dominant eye
      - color (String): Color of the lens
      - packageSize (Int): Number of lenses per package
      - quantity (Int): Number of packages
    - left (ContactsProductInput): undefined
      - productId (String): ID that uniquely maps to a manufacturer, brand, and potentially other parameters
      - diameter (String): The width of the contact lens from edge to edge measured by millimeters
      - baseCurve (String): Indication of the curvature of the inside of the lens
      - sphere (String): The amount of lens power measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
      - axis (String): The lens meridian with no cylinder power, indicated by a value between 1 and 180 degrees
      - cylinder (String): The amount of lens power for astigmatism measured in diopters (D), minus sign (–) for nearsighted, plus sign (+) for farsighted
      - addition (String): The additional magnifying power that applies to the bottom portion of multifocal lenses to fix presbyopia
      - dominance (String): Indication of dominant or non-dominant eye
      - color (String): Color of the lens
      - packageSize (Int): Number of lenses per package
      - quantity (Int): Number of packages
  - prescription (ContactsPrescriptionInput): undefined
    - fileId (String): File ID from *uploadFile* (conditionally required if *doctor* and *patient* are not set)
    - prescriptionId (String): Prescription ID
    - doctor (DoctorInput): Doctor details (conditionally required if prescription file ID is not set)
      - doctorId (String): Doctor ID (conditionally required if doctor name, practice name, and phone number are not set)
      - doctorName (String): Doctor name (conditionally required if doctor ID is not set)
      - practiceName (String): Practice name (conditionally required if doctor ID is not set)
      - phoneNumber (String): Phone number (conditionally required if doctor ID is not set)
      - faxNumber (String): Fax number
      - email (String): Doctor email address
      - address (String): Street address #1
      - address2 (String): Street address #2
      - city (String): City
      - state (String): State
      - zipCode (String): Zip code
      - url (String): Website URL
    - patient (PatientInput): Patient details (conditionally required if prescription file ID is not set)
      - patientId (String): Patient ID
      - firstName (String): First name
      - middleName (String): Middle name
      - lastName (String): Last name
      - dateOfBirth (String): Date of birth in ISO 8601 format, i.e., YYYY-MM-DD
      - phoneNumber (String): Phone number
      - email (String): Email address
      - address (String): Street address #1
      - address2 (String): Street address #2
      - city (String): City
      - state (String): State
      - zipCode (String): Zip code
      - schedulerLink (String): Scheduler link
    - products (ContactsProductsInput): Details about the prescribed contact lenses
      - right (ContactsProductInput)
      - left (ContactsProductInput)
    - issueDate (String): Issue date for the prescription YYYY-MM-DD format
    - expirationDate (String): Expiration date for the prescription YYYY-MM-DD format
- glasses (GlassesInput): Optional prescribed and ordered glasses
  - lenses (GlassesLensesInput): undefined
    - right (GlassesLensInput): undefined
      - type (GlassesLensType): Lens type
      - material (GlassesLensMaterial): Lens material
      - quality (GlassesLensQuality): Lens quality
      - color (String): Lens color
      - edge (GlassesLensEdge): Lens edge finish
      - addons (String): Additional anti-reflective, anti-fog, anti-scratch, and other coatings
      - focus (GlassesLensFocus): Lens focus
      - sphere (String): Sphere
      - cylinder (String): Cylinder
      - axis (String): Axis
      - addition (String): Addition
      - pupillaryDistance (PupillaryDistanceInput): Pupillary distance
      - segmentHeight (String): Segment height
      - prism (GlassesLensPrismInput): Prism corrections
    - left (GlassesLensInput): undefined
      - type (GlassesLensType): Lens type
      - material (GlassesLensMaterial): Lens material
      - quality (GlassesLensQuality): Lens quality
      - color (String): Lens color
      - edge (GlassesLensEdge): Lens edge finish
      - addons (String): Additional anti-reflective, anti-fog, anti-scratch, and other coatings
      - focus (GlassesLensFocus): Lens focus
      - sphere (String): Sphere
      - cylinder (String): Cylinder
      - axis (String): Axis
      - addition (String): Addition
      - pupillaryDistance (PupillaryDistanceInput): Pupillary distance
      - segmentHeight (String): Segment height
      - prism (GlassesLensPrismInput): Prism corrections
    - type (GlassesLensType): Lens type

    - material (GlassesLensMaterial): Lens material

    - quality (GlassesLensQuality): Lens quality

    - color (String): Lens color
    - edge (GlassesLensEdge): Lens edge finish

    - addons (String): Additional anti-reflective, anti-fog, anti-scratch, and other coatings
    - focus (GlassesLensFocus): Lens focus

    - sphere (String): Sphere
    - cylinder (String): Cylinder
    - axis (String): Axis
    - addition (String): Addition
    - pupillaryDistance (PupillaryDistanceInput): Pupillary distance
      - intermediate (Float): Used to indicate single pupillary distance value in millimeters;
Conditionally required if *near* and *distance* values are not provided
      - near (Float): Used to indicate pupillary distance for near vision in millimeters;
Conditionally required if *intermediate* value is not provided
      - distance (Float): Used to indicate pupillary distance for distance vision in millimeters;
Conditionally required if *intermediate* value is not provided
    - segmentHeight (String): Segment height
    - prism (GlassesLensPrismInput): Prism corrections
      - horizontal (GlassesLenPrismHorizontalInput): Horizontal prism power and direction
      - vertical (GlassesLenPrismVerticalInput): Vertical prism power and direction
  - frame (GlassesFrameInput): undefined
    - sku (String): Frame SKU
  - prescription (GlassesPrescriptionInput): undefined
    - fileId (String): File ID from *uploadFile*
    - prescriptionId (String): Prescription ID
    - doctor (DoctorInput): Prescribing doctor details
      - doctorId (String): Doctor ID (conditionally required if doctor name, practice name, and phone number are not set)
      - doctorName (String): Doctor name (conditionally required if doctor ID is not set)
      - practiceName (String): Practice name (conditionally required if doctor ID is not set)
      - phoneNumber (String): Phone number (conditionally required if doctor ID is not set)
      - faxNumber (String): Fax number
      - email (String): Doctor email address
      - address (String): Street address #1
      - address2 (String): Street address #2
      - city (String): City
      - state (String): State
      - zipCode (String): Zip code
      - url (String): Website URL
    - patient (PatientInput): Patient details
      - patientId (String): Patient ID
      - firstName (String): First name
      - middleName (String): Middle name
      - lastName (String): Last name
      - dateOfBirth (String): Date of birth in ISO 8601 format, i.e., YYYY-MM-DD
      - phoneNumber (String): Phone number
      - email (String): Email address
      - address (String): Street address #1
      - address2 (String): Street address #2
      - city (String): City
      - state (String): State
      - zipCode (String): Zip code
      - schedulerLink (String): Scheduler link
    - corrections (GlassesLensesInput): Prescribed corrections for distance, near, or multifocal lenses
      - right (GlassesLensInput)
      - left (GlassesLensInput)
      - type (GlassesLensType): Lens type
      - material (GlassesLensMaterial): Lens material
      - quality (GlassesLensQuality): Lens quality
      - color (String): Lens color
      - edge (GlassesLensEdge): Lens edge finish
      - addons (String): Additional anti-reflective, anti-fog, anti-scratch, and other coatings
      - focus (GlassesLensFocus): Lens focus
      - sphere (String): Sphere
      - cylinder (String): Cylinder
      - axis (String): Axis
      - addition (String): Addition
      - pupillaryDistance (PupillaryDistanceInput): Pupillary distance
      - segmentHeight (String): Segment height
      - prism (GlassesLensPrismInput): Prism corrections
    - issueDate (String): Issue date for the prescription YYYY-MM-DD format
    - expirationDate (String): Expiration date for the prescription YYYY-MM-DD format
- patient (PatientInput): Optional patient information
  - patientId (String): Patient ID
  - firstName (String): First name
  - middleName (String): Middle name
  - lastName (String): Last name
  - dateOfBirth (String): Date of birth in ISO 8601 format, i.e., YYYY-MM-DD
  - phoneNumber (String): Phone number
  - email (String): Email address
  - address (String): Street address #1
  - address2 (String): Street address #2
  - city (String): City
  - state (String): State
  - zipCode (String): Zip code
  - schedulerLink (String): Scheduler link
- tags (TagInput): Optional List of tags used to correlate this vision test with other systems
  - name (String): The name of the tag
  - value (String): The value of the tag

## Response
**Type:** Session
**Description:**
Start vision test response

### Fields
- launchUrl (String): The launch URL for the vision test
- jobId (String): The job ID for the vision-test job (if applicable, simulation support only)