> ## 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 Layer Validations

> Returns validation errors for all layer structures on a submission (only errors are reported; warnings are not surfaced here). When all layers are valid, `validations` is an empty list. When any layer is invalid, `validations` is instead an object keyed by `layer` (the only affected entity type for this endpoint), then by the offending layer's UUID, mapping to a list of `{message, field, verbose_name}` entries. An empty `validations` list means all layers are valid for acc/loc file generation.



## OpenAPI

````yaml https://vision.dev.pingintel.com/api/schema/?format=json get /api/v1/submission/{pingid}/cat/layers/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/layers/validate:
    get:
      tags:
        - CAT Modeling
      summary: Get Layer Validations
      description: >-
        Returns validation errors for all layer structures on a submission (only
        errors are reported; warnings are not surfaced here). When all layers
        are valid, `validations` is an empty list. When any layer is invalid,
        `validations` is instead an object keyed by `layer` (the only affected
        entity type for this endpoint), then by the offending layer's UUID,
        mapping to a list of `{message, field, verbose_name}` entries. An empty
        `validations` list means all layers are valid for acc/loc file
        generation.
      operationId: api_v1_submission_cat_layers_validate_retrieve
      parameters:
        - in: path
          name: pingid
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LayerValidations'
              examples:
                AllLayersValid:
                  value:
                    validations: []
                  summary: All layers valid
                InvalidLayer:
                  value:
                    validations:
                      layer:
                        019dd58e-eb2a-7958-8070-570003e4ee11:
                          - message: Field is required.
                            field: attachment
                            verbose_name: Attachment
                          - message: Field is required.
                            field: participation_percent
                            verbose_name: Participation Percent
                  summary: Invalid layer
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    LayerValidations:
      type: object
      properties:
        validations:
          description: >-
            Empty list (`[]`) when all layers are valid. Otherwise, an object
            keyed by `layer`, then by layer UUID, mapping to a list of
            validation messages, each with `message` (human-readable text),
            `field` (the offending field name, e.g. `attachment`), and
            `verbose_name` (title-cased field label, e.g. `Attachment`).
      required:
        - validations
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````