> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll Job

> Check the results of your Potential Notice job through this API



## OpenAPI

````yaml api-reference/tds/analytics/openapi.json GET /tds/analytics/potential-notices
openapi: 3.1.0
info:
  title: analytics
  version: 1.0.0
  description: ''
servers:
  - url: https://test-api.sandbox.co.in
  - url: https://api.sandbox.co.in
security: []
paths:
  /tds/analytics/potential-notices:
    get:
      tags:
        - Potential Notices
        - TDS
      summary: Fetch Potential Notice status
      parameters:
        - name: job_id
          in: query
          required: true
          description: Unique identifier of the job
          deprecated: false
          schema:
            type: string
            format: uuid
        - name: x-api-key
          in: header
          required: true
          description: API key for identification
          deprecated: false
          schema:
            type: string
        - name: authorization
          in: header
          required: true
          description: JWT access token
          deprecated: false
          schema:
            type: string
        - name: x-api-version
          in: header
          description: API Version
          schema:
            type: string
      responses:
        '200':
          description: 200 - OK
          content:
            application/json:
              schema:
                oneOf:
                  - title: Job Succeeded
                    type: object
                    properties:
                      code:
                        type: integer
                      timestamp:
                        type: integer
                      transaction_id:
                        type: string
                      data:
                        type: object
                        properties:
                          '@entity':
                            type: string
                            const: in.co.sandbox.tds.analytics.potential_notices.job
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          form:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
                          potential_notice_report_url:
                            type: string
                            format: uri
                  - title: Job Failed
                    type: object
                    properties:
                      code:
                        type: integer
                      timestamp:
                        type: integer
                      transaction_id:
                        type: string
                      data:
                        type: object
                        properties:
                          '@entity':
                            type: string
                            const: in.co.sandbox.tds.analytics.potential_notices.job
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          form:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
                          validation_report_url:
                            type: string
                            format: uri
                  - title: Job Queued
                    type: object
                    properties:
                      code:
                        type: integer
                      timestamp:
                        type: integer
                      transaction_id:
                        type: string
                      data:
                        type: object
                        properties:
                          '@entity':
                            type: string
                            const: in.co.sandbox.tds.analytics.potential_notices.job
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          form:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
              examples:
                200 Form 26Q Job Succeeded:
                  value:
                    code: 200
                    timestamp: 1763633700
                    transaction_id: 3b334f6d-dc27-4970-b90c-5c8b66bde88d
                    data:
                      '@entity': in.co.sandbox.tds.analytics.potential_notices.job
                      job_id: 1c1e4905-d07e-4c51-b8c5-1163050ded7f
                      tan: AHMA09719B
                      quarter: Q3
                      financial_year: FY 2023-24
                      form: 26Q
                      status: succeeded
                      created_at: 1709026684599
                      updated_at: 1711544847339
                      potential_notice_report_url: >-
                        https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/AHMS45586C/FY+2025-26/Q3/26Q/4049c226-4988-4978-b5ad-d25705453da8/26Q_validation_report.xlsx
                200 Form 27Q Job Succeeded:
                  value:
                    code: 200
                    timestamp: 1763633700
                    transaction_id: fd469cfd-6b11-494c-acac-5f8a6d87bb70
                    data:
                      '@entity': in.co.sandbox.tds.analytics.potential_notices.job
                      job_id: 7f4c8126-0a4c-48f3-939a-b73721092d2f
                      tan: AHMA09719B
                      quarter: Q3
                      financial_year: FY 2023-24
                      form: 27Q
                      status: succeeded
                      created_at: 1709026684599
                      updated_at: 1711544847339
                      potential_notice_report_url: >-
                        https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/AHMS45586C/FY+2025-26/Q3/26Q/4049c226-4988-4978-b5ad-d25705453da8/26Q_validation_report.xlsx
                200 Form 24Q Job Succeeded:
                  value:
                    code: 200
                    timestamp: 1763633700
                    transaction_id: a2af8434-a699-497e-b7d7-4ca35813c860
                    data:
                      '@entity': in.co.sandbox.tds.analytics.potential_notices.job
                      job_id: 1434930f-1516-42ff-945e-44d4105cca18
                      tan: AHMA09719B
                      quarter: Q4
                      financial_year: FY 2023-24
                      form: 24Q
                      status: succeeded
                      created_at: 1709026684599
                      updated_at: 1711544847339
                      potential_notice_report_urls: >-
                        https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/AHMS45586C/FY+2025-26/Q3/26Q/4049c226-4988-4978-b5ad-d25705453da8/26Q_validation_report.xlsx
                200 Job Queued:
                  value:
                    code: 200
                    timestamp: 1763633700000
                    transaction_id: 138658c5-2c5b-417f-8de4-2589f3263b5e
                    data:
                      '@entity': in.co.sandbox.tds.analytics.potential_notices.job
                      job_id: 53b385f8-8d76-4a72-8ccd-b6e81648c426
                      tan: AHMA09719B
                      quarter: Q3
                      financial_year: FY 2023-24
                      form: 26Q
                      status: queued
                      created_at: 1709026684599
                      updated_at: 1711544847339
                200 Job Failed:
                  value:
                    code: 200
                    timestamp: 1763633700000
                    transaction_id: c6750e71-0ad4-4061-a591-52ef02413c49
                    data:
                      '@entity': in.co.sandbox.tds.analytics.potential_notices.job
                      job_id: 05a3f586-5b2c-4f62-9f56-6600fcf9bc85
                      tan: BLRC23456F
                      quarter: Q3
                      financial_year: FY 2023-24
                      form: 26Q
                      status: failed
                      created_at: 1709026684599
                      updated_at: 1711544847339
                      validation_report_url: >-
                        https://in-co-sandbox-tds-analytics-potential-notices-test.s3.ap-south-1.amazonaws.com/tan/financial_year/quarter/form/5eb034b6-4b6f-4440-9ee0-88f7a220039b_validation_report.xlsx
        '422':
          description: 422 - Unprocessable Entity
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  timestamp:
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
              examples:
                422 Invalid Job ID:
                  value:
                    code: 422
                    timestamp: 1763633700000
                    transaction_id: 1d84cdcd-e9c4-4daf-a98c-983a18bc059f
                    message: 'Invalid job id: 12234-555'
        '521':
          description: 521 - Data Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  timestamp:
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
              examples:
                521 Data not found:
                  value:
                    code: 521
                    timestamp: 1763633700000
                    transaction_id: f79037ec-d96f-48d2-bf4a-d8978294bb50
                    message: 'Data not found: null'

````