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

# List Recent Submission Activity

> Fetch a list of the most recent submission activity.  If desired, the returned `fields` can be configured and the responses can be filtered by `status`, `origin`, etc.



## OpenAPI

````yaml https://vision.staging.pingintel.com/api/schema/?format=json get /api/v1/submission
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:
    get:
      tags:
        - Get Submission Data
      summary: List Recent Submission Activity
      description: >-
        Fetch a list of the most recent submission activity.  If desired, the
        returned `fields` can be configured and the responses can be filtered by
        `status`, `origin`, etc.
      operationId: api_v1_submission_retrieve
      parameters:
        - in: query
          name: claimed_by_id
          schema:
            type: integer
          description: Optional filter by assigned user.
        - in: query
          name: cursor_id
          schema:
            type: string
          description: >-
            Optional. When this parameter is set from the cursor_id provided in
            a previous response, the page of results will start with the next
            item.
        - in: query
          name: fields
          schema:
            type: string
          description: Optional. List of field names to include on each result.
        - in: query
          name: id
          schema:
            type: string
          description: Optional filter for submission pingid.
        - in: query
          name: page_size
          schema:
            type: integer
          description: Optional. The maximum number of results returned in a page.
        - in: query
          name: search
          schema:
            type: string
          description: Optional. Global search substring. Case insensitive.
        - in: query
          name: team_name
          schema:
            type: string
          description: Optional filter for organizations.
        - in: query
          name: team_uuid
          schema:
            type: integer
          description: Optional filter by team.
        - in: query
          name: workflow_status_uuid
          schema:
            type: string
          description: Optional filter by workflow status.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSubmissionActivityResponse'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmissionActivityErrorResponse'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse401'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse403'
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    ListSubmissionActivityResponse:
      type: object
      description: Return
      properties:
        cursor_id:
          type: string
        has_remaining:
          type: boolean
          description: True if there are more records available.
        results:
          type: array
          items:
            $ref: '#/components/schemas/ListSubmissionActivityResponseResults'
          description: Records returned in this page of results.
        total_size_without_cursors:
          type: string
          description: Description of total list size.
      required:
        - cursor_id
        - has_remaining
        - results
        - total_size_without_cursors
    SubmissionActivityErrorResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Request ID
        message:
          type: string
          description: Server error message detail
      required:
        - id
        - message
    ErrorResponse401:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Request ID
        message:
          type: string
          description: Authorization error message.
      required:
        - id
        - message
    ErrorResponse403:
      type: object
      properties:
        detail:
          type: string
          description: Error message.
      required:
        - detail
    ListSubmissionActivityResponseResults:
      type: object
      properties:
        actions:
          type: array
          items:
            $ref: '#/components/schemas/ListSubmissionActivityResponseResultsActions'
        automated_processing_failed:
          type: boolean
          description: True if automated processing failed.
        automated_processing_failed_reason:
          type: string
          description: Reason for automated processing failure.
        broker_assistant_name:
          type: string
          description: Broker assistant name.
        broker_city:
          type: string
          description: Broker city.
        broker_contact_name:
          type: string
          description: Broker contact name.
        broker_country:
          type: string
          description: Broker country.
        broker_email:
          type: string
          description: Broker email.
        broker_fein:
          type: string
          description: Broker FEIN.
        broker_full_address:
          type: string
          description: Broker full address.
        broker_name:
          type: string
          description: Broker name.
        broker_state:
          type: string
          description: Broker state.
        broker_street:
          type: string
          description: Broker street.
        broker_street2:
          type: string
          description: Broker street 2.
        broker_zip:
          type: string
          description: Broker zip.
        cat_modeling_term_selectors_read_only:
          type: boolean
          description: Is cat modeling term selectors read-only.
        claimed_by__username:
          type: string
          description: Claimed by username.
        claimed_by_id:
          type: string
          description: Claimed by ID.
        client_ref:
          type: string
          description: Client reference.
        company_name:
          type: string
          description: Company name.
        company_short_name:
          type: string
          description: Company short name.
        created_by__username:
          type: string
          description: Created by username.
        created_by_id:
          type: string
          description: Created by ID.
        created_time:
          type: string
          format: date-time
          description: Created time.
        data_readiness_notes:
          type: string
          description: Data readiness notes.
        data_readiness_score:
          type: integer
          description: Data readiness score.
        division_name:
          type: string
          description: Division name.
        division_short_name:
          type: string
          description: Division short name.
        division_uuid:
          type: string
          format: uuid
          description: Division UUID.
        documents:
          type: array
          items:
            $ref: >-
              #/components/schemas/ListSubmissionActivityResponseResultsDocuments
        email_subject:
          type: string
          description: Email subject.
        expiration_date:
          type: string
          format: date-time
          description: Expiration date.
        extra_data:
          type: object
          additionalProperties: {}
          description: Extra data.
        from_email:
          type: string
          description: From email.
        global_request_id:
          type: string
          description: Global request ID.
        home_state:
          type: string
          description: Home state.
        id:
          type: string
          description: ID.
        inception_date:
          type: string
          format: date-time
          description: Inception date.
        insured_business_description:
          type: string
          description: Insured business description.
        insured_city:
          type: string
          description: Insured city.
        insured_contact_email:
          type: string
          description: Insured contact email.
        insured_contact_name:
          type: string
          description: Insured contact name.
        insured_contact_phone:
          type: string
          description: Insured contact phone.
        insured_country:
          type: string
          description: Insured country.
        insured_fein:
          type: string
          description: Insured FEIN.
        insured_full_address:
          type: string
          description: Insured full address.
        insured_gl_code:
          type: string
          description: Insured GL code.
        insured_name:
          type: string
          description: Insured name.
        insured_ofac_status:
          type: string
          description: Insured OFAC status.
        insured_sic:
          type: string
          description: Insured SIC.
        insured_state:
          type: string
          description: Insured state.
        insured_street:
          type: string
          description: Insured street.
        insured_street2:
          type: string
          description: Insured street 2.
        insured_website:
          type: string
          description: Insured website.
        insured_zip:
          type: string
          description: Insured zip.
        is_building_data_ready:
          type: boolean
          description: Is building data ready.
        is_ping_certified:
          type: boolean
        jobs:
          type: array
          items:
            $ref: '#/components/schemas/ListSubmissionActivityResponseResultsJobs'
        limits_bi_limit:
          type: string
          description: Limits BI limit.
        limits_bpp_limit:
          type: string
          description: Limits contents limit.
        limits_building_limit:
          type: string
          description: Limits building limit.
        limits_signs_and_other_limit:
          type: string
          description: Limits signs and other limit.
        limits_total_limit:
          type: string
          description: Limits total limit.
        modified_time:
          type: string
          format: date-time
          description: Modified time.
        num_buildings:
          type: string
          description: Number of buildings.
        ping_maps:
          $ref: '#/components/schemas/ListSubmissionActivityResponseResultsPingMaps'
        pk:
          type: string
          description: Primary key.
        primary_naics_code:
          type: string
          description: Insured NAICS.
        received_time:
          type: string
          format: date-time
          description: Received time.
        rule_results:
          type: array
          items:
            $ref: >-
              #/components/schemas/ListSubmissionActivityResponseResultsTriageRuleResults
        rules_overall_result:
          type: string
          description: Triage rules overall result.
        source__inbox_email_address:
          type: string
          description: Source inbox email address.
        source__source_type:
          type: string
          description: Source type.
        source__source_type_display:
          type: string
          description: Source type display.
        statistics:
          type: object
          additionalProperties: {}
          description: Statistics.
        team_name:
          type: string
          description: Team name.
        team_uuid:
          type: string
          format: uuid
          description: Team UUID.
        wholesale_broker_city:
          type: string
          description: Wholesale broker city.
        wholesale_broker_country:
          type: string
          description: Wholesale broker country.
        wholesale_broker_email:
          type: string
          description: Wholesale broker email.
        wholesale_broker_fein:
          type: string
          description: Wholesale broker FEIN.
        wholesale_broker_license_number:
          type: string
          description: Wholesale broker license number.
        wholesale_broker_license_state:
          type: string
          description: Wholesale broker license state.
        wholesale_broker_name:
          type: string
          description: Wholesale broker name.
        wholesale_broker_phone:
          type: string
          description: Wholesale broker phone.
        wholesale_broker_state:
          type: string
          description: Wholesale broker state.
        wholesale_broker_street:
          type: string
          description: Wholesale broker street.
        wholesale_broker_street2:
          type: string
          description: Wholesale broker street 2.
        wholesale_broker_zip:
          type: string
          description: Wholesale broker zip.
        workflow_status_name:
          type: string
          description: Workflow status name.
        workflow_status_uuid:
          type: string
          description: Workflow status ID.
      required:
        - actions
        - automated_processing_failed
        - automated_processing_failed_reason
        - broker_assistant_name
        - broker_city
        - broker_contact_name
        - broker_country
        - broker_email
        - broker_fein
        - broker_full_address
        - broker_name
        - broker_state
        - broker_street
        - broker_street2
        - broker_zip
        - cat_modeling_term_selectors_read_only
        - claimed_by__username
        - claimed_by_id
        - client_ref
        - company_name
        - company_short_name
        - created_by__username
        - created_by_id
        - created_time
        - data_readiness_notes
        - data_readiness_score
        - division_name
        - division_short_name
        - division_uuid
        - documents
        - email_subject
        - expiration_date
        - extra_data
        - from_email
        - global_request_id
        - home_state
        - id
        - inception_date
        - insured_business_description
        - insured_city
        - insured_contact_email
        - insured_contact_name
        - insured_contact_phone
        - insured_country
        - insured_fein
        - insured_full_address
        - insured_gl_code
        - insured_name
        - insured_ofac_status
        - insured_sic
        - insured_state
        - insured_street
        - insured_street2
        - insured_website
        - insured_zip
        - is_building_data_ready
        - is_ping_certified
        - jobs
        - limits_bi_limit
        - limits_bpp_limit
        - limits_building_limit
        - limits_signs_and_other_limit
        - limits_total_limit
        - modified_time
        - num_buildings
        - ping_maps
        - pk
        - primary_naics_code
        - received_time
        - rule_results
        - rules_overall_result
        - source__inbox_email_address
        - source__source_type
        - source__source_type_display
        - statistics
        - team_name
        - team_uuid
        - wholesale_broker_city
        - wholesale_broker_country
        - wholesale_broker_email
        - wholesale_broker_fein
        - wholesale_broker_license_number
        - wholesale_broker_license_state
        - wholesale_broker_name
        - wholesale_broker_phone
        - wholesale_broker_state
        - wholesale_broker_street
        - wholesale_broker_street2
        - wholesale_broker_zip
        - workflow_status_name
        - workflow_status_uuid
    ListSubmissionActivityResponseResultsActions:
      type: object
      properties:
        claim:
          type: boolean
          description: True if the submission can be claimed.
        download_documents:
          type: boolean
          description: True if documents can be downloaded.
        transition_to:
          type: object
          additionalProperties:
            type: string
          description: Legal transition statuses for change_status.
        view_map:
          type: boolean
          description: True if map can be viewed.
      required:
        - claim
        - download_documents
        - transition_to
        - view_map
    ListSubmissionActivityResponseResultsDocuments:
      type: object
      properties:
        actions:
          type: array
          items:
            type: string
          description: Actions available for the document.
        archived_on:
          type: string
          format: date-time
          description: Archived on date.
        archived_reason:
          type: string
          description: Reason for archiving.
        created_time:
          type: string
          format: date-time
          description: Created time.
        document_type:
          type: string
          description: Document type.
        extension:
          type: string
          description: File extension.
        filename:
          type: string
          description: Filename.
        id:
          type: string
          description: ID.
        is_archived:
          type: boolean
          description: True if the document is archived.
        preview_url:
          type: string
          description: Preview URL.
        url:
          type: string
          description: URL.
      required:
        - actions
        - archived_on
        - archived_reason
        - created_time
        - document_type
        - extension
        - filename
        - id
        - is_archived
        - preview_url
        - url
    ListSubmissionActivityResponseResultsJobs:
      type: object
      properties:
        created_time:
          type: string
          format: date-time
          description: Created time.
        filenames:
          type: array
          items:
            type: string
          description: List of filenames.
        hidden:
          type: boolean
          description: Whether this job is hidden by default in the UI.
        job_id:
          type: string
          description: Job ID.
        job_type:
          type: string
          description: Job type.
        job_type_details:
          type: object
          additionalProperties: {}
          description: Details about the job type.
        processing_last_message:
          type: string
          description: Last message from processing.
        processing_pct_complete:
          type: number
          format: double
          description: Processing percentage complete.
        processing_status:
          type: string
          description: Processing status.
        updated_time:
          type: string
          format: date-time
          description: Updated time.
        user_id:
          type: string
          description: User ID.
      required:
        - created_time
        - filenames
        - hidden
        - job_id
        - job_type
        - job_type_details
        - processing_last_message
        - processing_pct_complete
        - processing_status
        - updated_time
        - user_id
    ListSubmissionActivityResponseResultsPingMaps:
      type: object
      properties:
        status:
          type: string
          description: Status of the ping map.
        status_display:
          type: string
          description: Display status of the ping map.
        status_pct_complete:
          type: integer
          description: Percentage of completion of the ping map.
        status_reason:
          type: string
          description: Reason for the current status.
        url:
          type: string
          nullable: true
          description: URL of the ping map.
      required:
        - status
        - status_display
        - status_pct_complete
        - status_reason
    ListSubmissionActivityResponseResultsTriageRuleResults:
      type: object
      properties:
        ran_at:
          type: string
          format: date-time
          description: Date and time when the rule was run.
        result:
          type: string
          description: Result of the rule.
        rule:
          type: string
          description: Name of the rule.
        value:
          type: string
          description: Human-readable formatted value of the rule.
      required:
        - ran_at
        - result
        - rule
        - value
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````