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

# Get Coverage Option Validations

> Returns validation errors for a coverage option (only errors are reported; warnings are not surfaced here). When the coverage option is valid, `validations` is an empty list. When it is invalid, `validations` is instead an object keyed by what the error affects (`peril_group`, `zone`, or `coverage_option`), then by the UUID of the specific peril group/zone/coverage option, mapping to a list of `{message, field, verbose_name}` entries. Only coverage options that pass validation are eligible for acc/loc file generation.



## OpenAPI

````yaml https://vision.dev.pingintel.com/api/schema/?format=json get /api/v1/submission/{pingid}/cat/coverage-options/{coverage_option_uuid}/validate
openapi: 3.0.3
info:
  title: Ping.Vision API
  version: v1.0
  description: >
    ### Ping.Vision API


    This API provides convenient, efficient access to Ping Intel's data and
    services. It is designed to be used by developers and data scientists to
    integrate Ping Intel's capabilities into their applications.


    Once SSO is set up with your organization, you can create an Organization or
    Personal API key at https://auth.pingintel.com/org.


    Please see the Python client library
    [pingintel-api](https://pypi.org/project/pingintel-api/) for commandline
    tools and programmatic access, and you

    can refer to the following documentation for details on interacting with the
    system via the HTTP API.
  contact:
    email: support@pingintel.com
    name: Ping Intel
    url: https://www.pingintel.com
servers:
  - url: https://vision.pingintel.com
    description: Ping.Vision API
  - url: https://vision.staging.pingintel.com
    description: Ping.Vision API (staging)
security: []
tags:
  - name: Create Submission
    description: The Create Submission API allows you to add new data into the system.
  - name: Update Submission
    description: >-
      The Update Submission API provides various endpoints to update, modify, or
      act upon existing submissions.
  - name: Get Submission Data
    description: ''
  - name: User Memberships
    description: >-
      The User Memberships API allows you to add, remove, and change the role of
      users in different teams, divisions, or companies.
  - name: Miscellaneous
    description: ''
paths:
  /api/v1/submission/{pingid}/cat/coverage-options/{coverage_option_uuid}/validate:
    get:
      tags:
        - CAT Modeling
      summary: Get Coverage Option Validations
      description: >-
        Returns validation errors for a coverage option (only errors are
        reported; warnings are not surfaced here). When the coverage option is
        valid, `validations` is an empty list. When it is invalid, `validations`
        is instead an object keyed by what the error affects (`peril_group`,
        `zone`, or `coverage_option`), then by the UUID of the specific peril
        group/zone/coverage option, mapping to a list of `{message, field,
        verbose_name}` entries. Only coverage options that pass validation are
        eligible for acc/loc file generation.
      operationId: api_v1_submission_cat_coverage_options_validate_retrieve
      parameters:
        - in: path
          name: coverage_option_uuid
          schema:
            type: string
          required: true
        - in: path
          name: pingid
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CoverageOptionValidations'
              examples:
                ValidCoverageOption:
                  value:
                    validations: []
                  summary: Valid coverage option
                InvalidCoverageOption:
                  value:
                    validations:
                      peril_group:
                        019dd58e-eb2a-7958-8070-570003e4ee51:
                          - message: Field is required.
                            field: bi_days_deductible
                            verbose_name: Bi Days Deductible
                      coverage_option:
                        019dd58e-eb2a-7958-8070-570003e4ee29:
                          - message: Must be between 0 and 365.
                            field: default_bi_period_days
                            verbose_name: Default Bi Period Days
                  summary: Invalid coverage option
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    CoverageOptionValidations:
      type: object
      properties:
        validations:
          description: >-
            Empty list (`[]`) when the coverage option is valid. Otherwise, an
            object keyed by affected entity type (`peril_group`, `zone`,
            `coverage_option`), then by that entity's UUID, mapping to a list of
            validation messages, each with `message` (human-readable text),
            `field` (the offending field name, e.g. `bi_days_deductible`), and
            `verbose_name` (title-cased field label, e.g. `Bi Days Deductible`).
      required:
        - validations
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````