> ## 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.

# Acc/Loc File Status

> **⚠️ Under active development — subject to change.**

Returns the current status of an acc/loc file generation job and download URLs for completed files.



## OpenAPI

````yaml https://vision.staging.pingintel.com/api/schema/?format=json get /api/v1/submission/{pingid}/cat/acc-loc-files/{uuid}
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/acc-loc-files/{uuid}:
    get:
      tags:
        - CAT Modeling
      summary: Acc/Loc File Status
      description: >-
        **⚠️ Under active development — subject to change.**


        Returns the current status of an acc/loc file generation job and
        download URLs for completed files.
      operationId: api_v1_submission_cat_acc_loc_files_retrieve
      parameters:
        - in: path
          name: pingid
          schema:
            type: string
          description: Ping ID of the submission.
          required: true
        - in: path
          name: uuid
          schema:
            type: string
          description: UUID of the acc/loc file generation job.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccLocFileJob'
              examples:
                InProgress:
                  value:
                    uuid: a1b2c3d4-0000-0000-0000-000000000001
                    status: I
                    processing_pct_complete: 50
                    modeling_sets:
                      - status: I
                        acc_file_url: null
                        loc_file_url: null
                        cat_model_type: AIR
                        use_secondary_modifiers: true
                        use_ping_geocoding: false
                        modeling_option_uuid: a1b2c3d4-0000-0000-0000-000000000001
                        coverate_option_uuid: a1b2c3d4-0000-0000-0000-000000000010
                        layer_structure_uuid: a1b2c3d4-0000-0000-0000-000000009999
                        layer_uuids:
                          - a1b2c3d4-0000-0000-0000-000000000101
                          - a1b2c3d4-0000-0000-0000-000000000102
                        layer_output: C
                      - status: F
                        acc_file_url: null
                        loc_file_url: null
                        cat_model_type: AIR
                        use_secondary_modifiers: true
                        use_ping_geocoding: false
                        modeling_option_uuid: a1b2c3d4-0000-0000-0000-000000000002
                        coverate_option_uuid: a1b2c3d4-0000-0000-0000-000000000011
                        layer_structure_uuid: a1b2c3d4-0000-0000-0000-000000009999
                        layer_uuids:
                          - a1b2c3d4-0000-0000-0000-000000000101
                          - a1b2c3d4-0000-0000-0000-000000000102
                        layer_output: C
                  summary: In progress
                Complete:
                  value:
                    uuid: a1b2c3d4-0000-0000-0000-000000000001
                    status: C
                    processing_pct_complete: 100
                    modeling_sets:
                      - status: C
                        acc_file_url: https://example.com/co-1-acc.csv
                        loc_file_url: https://example.com/co-1-loc.csv
                        cat_model_type: AIR
                        use_secondary_modifiers: true
                        use_ping_geocoding: false
                        modeling_option_uuid: a1b2c3d4-0000-0000-0000-000000000001
                        coverate_option_uuid: a1b2c3d4-0000-0000-0000-000000000010
                        layer_structure_uuid: a1b2c3d4-0000-0000-0000-000000009999
                        layer_uuids:
                          - a1b2c3d4-0000-0000-0000-000000000101
                          - a1b2c3d4-0000-0000-0000-000000000102
                        layer_output: C
                      - status: C
                        acc_file_url: https://example.com/co-2-acc.csv
                        loc_file_url: https://example.com/co-2-loc.csv
                        cat_model_type: AIR
                        use_secondary_modifiers: true
                        use_ping_geocoding: false
                        modeling_option_uuid: a1b2c3d4-0000-0000-0000-000000000002
                        coverate_option_uuid: a1b2c3d4-0000-0000-0000-000000000011
                        layer_structure_uuid: a1b2c3d4-0000-0000-0000-000000009999
                        layer_uuids:
                          - a1b2c3d4-0000-0000-0000-000000000101
                          - a1b2c3d4-0000-0000-0000-000000000102
                        layer_output: C
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    AccLocFileJob:
      type: object
      properties:
        modeling_sets:
          type: array
          items:
            $ref: '#/components/schemas/ModelingSet'
          description: >-
            Acc/Loc file pairs being generated. Each entry has its own status
            and may complete independently before the overall job is finished.
        processing_pct_complete:
          type: integer
          description: >-
            An integer from 0 to 100 indicating the percentage of the job that
            is complete. When status is `C`, this will be 100; when status is
            `I`, this may be 0 or some intermediate value; when status is `F`,
            this may be 0, 100, or some intermediate value depending on when the
            failure occurred.
        status:
          enum:
            - 'N'
            - I
            - C
            - F
          type: string
          x-spec-enum-id: 62fef98fcd687813
          description: >-
            `N`: job is not processed. `I`: job is in progress. `C`: files are
            ready. `F`: generation encountered an error.


            * `N` - Not Processed

            * `I` - In Progress

            * `C` - Completed

            * `F` - Failed
        uuid:
          type: string
          format: uuid
          description: Unique identifier for this generation job.
      required:
        - modeling_sets
        - processing_pct_complete
        - status
        - uuid
    ModelingSet:
      type: object
      properties:
        acc_file_url:
          type: string
          readOnly: true
          description: >-
            Pre-signed download URL for the generated acc file. Null until
            status is `complete`.
        cat_model_type:
          enum:
            - AIR
            - RMS
          type: string
          x-spec-enum-id: 6ec9844f44dcfbf7
          description: |-
            CAT model these files were generated for.

            * `AIR` - AIR Modeling
            * `RMS` - RMS Modeling
        coverage_option_uuid:
          type: string
          format: uuid
          description: UUID of the coverage option this file pair was generated for.
        layer_output:
          enum:
            - C
            - P
          type: string
          x-spec-enum-id: 560025be91e18ee1
          description: >-
            Controls whether mutiple layers are included in a single acc/loc
            file pair, or independently in a set of files for each layer. `C` =
            combined, `P` = per layer.


            * `C` - Combined

            * `P` - Per Layer
        layer_structure_uuid:
          type: string
          format: uuid
          description: UUID of the layer structure this file pair was generated for.
        layer_uuids:
          type: string
          readOnly: true
          description: >-
            UUIDs of the layers this file pair was generated for. Only populated
            when layer_output=per_layer.
        loc_file_url:
          type: string
          readOnly: true
          description: >-
            Pre-signed download URL for the generated loc file. Null until
            status is `complete`.
        modeling_option_uuid:
          type: string
          format: uuid
          description: UUID of the modeling option this file pair was generated for.
        status:
          enum:
            - Q
            - I
            - C
            - F
          type: string
          x-spec-enum-id: 62e2f2047a3eaed8
          description: |-
            `Q`: Queued. `I`: In Progress. `C`: Complete. `F`: Failed.

            * `Q` - Queued
            * `I` - In Progress
            * `C` - Complete
            * `F` - Failed
        use_ping_geocoding:
          type: boolean
          description: Whether Ping-derived lat/longs were included in the generated files.
        use_secondary_modifiers:
          type: boolean
          description: Whether secondary modifiers were included in the generated files.
      required:
        - acc_file_url
        - cat_model_type
        - coverage_option_uuid
        - layer_output
        - layer_structure_uuid
        - layer_uuids
        - loc_file_url
        - modeling_option_uuid
        - status
        - use_ping_geocoding
        - use_secondary_modifiers
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````