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

> Fetch the TXT file generated for preparing the TCS return.



## OpenAPI

````yaml api-reference/tds/reports/openapi.json GET /tcs/reports/txt
openapi: 3.1.0
info:
  title: reports
  version: 1.0.0
  description: ''
servers:
  - url: https://test-api.sandbox.co.in
  - url: https://api.sandbox.co.in
security: []
paths:
  /tcs/reports/txt:
    get:
      tags:
        - TCS
      summary: Fetch TCS Reports status
      parameters:
        - name: job_id
          in: query
          required: true
          description: Unique identifier of the job
          deprecated: false
          schema:
            type: string
          examples:
            200 - Success:
              summary: 200 - Success
              value: c01f847c-c42e-4577-9d01-a7208401a922
            200 - Job Queued:
              summary: 200 - Job Queued
              value: 0fb396f6-9eb6-48b9-926d-25296286f9ee
            200 - Job Succeeded:
              summary: 200 - Job Succeeded
              value: 46d96540-e4e0-4188-81f5-959f4732490f
            200 - Job Failed:
              summary: 200 - Job Failed
              value: 77a45361-9646-4ee0-93ed-9471bb8a615e
            521 - Data not found:
              summary: 521 - Data not found
              value: '{{job_id}}'
        - name: authorization
          in: header
          required: true
          description: JWT access token
          deprecated: false
          schema:
            type: string
        - name: x-api-key
          in: header
          required: true
          description: API key for identification
          deprecated: false
          schema:
            type: string
        - name: x-api-version
          in: header
          schema:
            type: string
      responses:
        '200':
          description: 200 - OK
          content:
            application/json:
              schema:
                oneOf:
                  - title: Job Queued
                    type: object
                    properties:
                      code:
                        type: integer
                      timestamp:
                        type: integer
                      transaction_id:
                        type: string
                      data:
                        type: object
                        properties:
                          '@entity':
                            type: string
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          previous_receipt_number:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
                  - title: Job Succeeded
                    type: object
                    properties:
                      code:
                        type: integer
                      timestamp:
                        type: integer
                      transaction_id:
                        type: string
                      data:
                        type: object
                        properties:
                          '@entity':
                            type: string
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          previous_receipt_number:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
                          txt_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
                          job_id:
                            type: string
                          tan:
                            type: string
                          quarter:
                            type: string
                          financial_year:
                            type: string
                          previous_receipt_number:
                            type: string
                          status:
                            type: string
                          created_at:
                            type: integer
                          updated_at:
                            type: integer
                          validation_report_url:
                            type: string
                            format: uri
              examples:
                200 - Success:
                  summary: 200 - Success
                  value:
                    code: 200
                    timestamp: 1763102487000
                    transaction_id: '9bd36a1d-bd63-439f-8115-5b4b2948bda8 '
                    data:
                      '@entity': in.co.sandbox.tcs.reports.job
                      job_id: c01f847c-c42e-4577-9d01-a7208401a922
                      tan: AHMA09719B
                      quarter: Q3
                      financial_year: FY 2023-24
                      previous_receipt_number: '123456789012345'
                      status: created
                      created_at: 1701250588000
                200 - Job Queued:
                  summary: 200 - Job Queued
                  value:
                    code: 200
                    timestamp: 1763362637000
                    transaction_id: e2b9145f-69d5-4bbe-a6de-be6fc08b426f
                    data:
                      '@entity': in.co.sandbox.tcs.reports.job
                      job_id: 0fb396f6-9eb6-48b9-926d-25296286f9ee
                      tan: BLRC23456F
                      quarter: Q4
                      financial_year: FY 2023-24
                      previous_receipt_number: '123456789012345'
                      status: queued
                      created_at: 1701250588000
                      updated_at: 17012506755000
                200 - Job Succeeded:
                  summary: 200 - Job Succeeded
                  value:
                    code: 200
                    timestamp: 1763362637000
                    transaction_id: e2b9145f-69d5-4bbe-a6de-be6fc08b426f
                    data:
                      '@entity': in.co.sandbox.tcs.reports.job
                      job_id: 46d96540-e4e0-4188-81f5-959f4732490f
                      tan: AHMA09719B
                      quarter: Q3
                      financial_year: FY 2023-24
                      previous_receipt_number: '123456789012345'
                      status: succeeded
                      created_at: 1701250588000
                      updated_at: 17012507755000
                      txt_url: >-
                        https://s3.ap-south-1.amazonaws.com/in-co-sandbox-tcs-reports-test/tan/financial_year/quarter/80716d9a-4aa0-4905-8ff1-0aca61042a0e_report.txt
                200 - Job Failed:
                  summary: 200 - Job Failed
                  value:
                    code: 200
                    timestamp: 1763362637000
                    transaction_id: e2b9145f-69d5-4bbe-a6de-be6fc08b426f
                    data:
                      '@entity': in.co.sandbox.tcs.reports.job
                      job_id: 77a45361-9646-4ee0-93ed-9471bb8a615e
                      tan: BLRC23456F
                      quarter: Q3
                      financial_year: FY 2023-24
                      previous_receipt_number: '123456789012345'
                      status: failed
                      created_at: 1701250588000
                      updated_at: 17012507755000
                      validation_report_url: >-
                        https://s3.ap-south-1.amazonaws.com/in-co-sandbox-tcs-reports-test/tan/financial_year/quarter/80716d9a-4aa0-4905-8ff1-0aca61042a0e_validation_report.xlsx
        '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:
                  summary: 521 - Data not found
                  value:
                    code: 521
                    timestamp: 1763362637000
                    transaction_id: e2b9145f-69d5-4bbe-a6de-be6fc08b426f
                    message: 'Data not found: 174b4fbf-0d0f-4c46-93d8-790d6d3ae0ee'

````