> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gonitro.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Results

> Get result of asynchronous Job.

 A Job is Nitro’s asynchronous file processing for PDF Transformation, Conversion, and Extraction operations.

The Job Result endpoint returns the result of an asynchronous Conversion, Transformation, or Extraction job.

The possible values of the status field are:

* `completed`: The job completed successfully. The response includes the result: one or more file links for Conversion and Transformation jobs, a JSON payload for Extraction jobs, or a binary string.
* `failed`: The job failed during processing. The response includes an error field describing the failure.
* `canceled`: The job was canceled by the user.

If the job is still running, the endpoint returns a 404 Not Found response, as the result is not yet available.


## OpenAPI

````yaml job GET /jobs/{jobID}
openapi: 3.0.3
info:
  title: Nitro API - Document Intelligence Platform
  description: >-
    Consolidated API for document intelligence operations including conversions,
    extractions, transformations, and job management.


    **Supported Operations:**

    - **Conversions**: PDF ↔ MS Office, Images ↔ PDF, Various formats to PDF

    - **Extractions**: Text extraction, PII detection, Bounding box extraction,
    PDF properties

    - **Transformations**: Rotate, Split, Merge, Flatten, Compress, Password
    protection, Redaction

    - **Jobs**: Asynchronous processing with status monitoring and result
    retrieval


    **Global Limits:**

    - Maximum file size: 25MB

    - Maximum number of pages: 200
  version: 1.0.0
  contact:
    name: Nitro API Support
    url: https://help.gonitro.com/support
servers:
  - url: https://api.gonitro.dev
    description: API server
security: []
tags:
  - name: Conversions
    description: >-
      Document format conversion operations including PDF to/from MS Office,
      images, and various other formats
  - name: Extractions
    description: >-
      Data extraction operations for text, metadata, PII detection, and bounding
      box information
  - name: Transformations
    description: >-
      PDF transformation operations including rotation, splitting, merging,
      compression, protection, and redaction
  - name: Jobs
    description: >-
      Asynchronous job management for monitoring, retrieving results, and
      canceling long-running operations
paths:
  /jobs/{jobID}:
    get:
      tags:
        - Jobs
      summary: Get Job Result
      description: |-
        Get result of asynchronous Job.

         A Job is Nitro’s asynchronous file processing for PDF Transformation, Conversion, and Extraction operations.
      parameters:
        - name: Accept
          in: header
          schema:
            $ref: '#/components/schemas/AcceptHeader'
        - name: jobID
          in: path
          required: true
          schema:
            type: string
          description: The unique identifier of the job.
      responses:
        '200':
          description: Job result
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/PlatformJobResultCompleted'
                  - $ref: '#/components/schemas/JobResultFailedGeneric'
                  - $ref: '#/components/schemas/JobCanceledResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '413':
          $ref: '#/components/responses/ContentTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - BearerAuth: []
components:
  schemas:
    AcceptHeader:
      type: string
      enum:
        - application/json
        - application/octet-stream
        - '*/*'
      default: '*/*'
      description: >-
        Controls response format and behavior. See endpoint description above
        for detailed response combinations.

        - `application/json`: Returns JSON response with operation result

        - `application/octet-stream`: Returns binary file content 

        - `*/*`: Defaults to JSON response
    PlatformJobResultCompleted:
      allOf:
        - type: object
          properties:
            jobID:
              type: string
              example: 01234567-89ab-cdef-0123-456789abcdef
            status:
              type: string
              enum:
                - completed
        - type: object
          title: Completed
          properties:
            result:
              description: >-
                The result is returned as data in the same format as the
                original request's synchronous response type. 
                 Transformations and Conversions return one or more files, while Extractions return a JSON object containing the requested data.
              oneOf:
                - $ref: '#/components/schemas/PlatformOperationFileResult'
                - $ref: '#/components/schemas/PlatformOperationFilesResult'
                - $ref: '#/components/schemas/StringResultType'
                - $ref: '#/components/schemas/TablesResultType'
                - $ref: '#/components/schemas/TextBoxResultType'
                - $ref: '#/components/schemas/PIIResultType'
                - $ref: '#/components/schemas/PropertiesTypes'
                - $ref: '#/components/schemas/FormResultType'
    JobResultFailedGeneric:
      type: object
      title: Failed
      properties:
        jobID:
          type: string
          example: 01234567-89ab-cdef-0123-456789abcdef
        status:
          type: string
          enum:
            - failed
        error:
          $ref: '#/components/schemas/JobError'
    JobCanceledResponse:
      type: object
      title: Canceled
      properties:
        jobID:
          type: string
          example: 01234567-89ab-cdef-0123-456789abcdef
        status:
          type: string
          enum:
            - canceled
    PlatformOperationFileResult:
      type: object
      title: Sync - Single File
      properties:
        file:
          $ref: '#/components/schemas/FileInfo'
    PlatformOperationFilesResult:
      type: object
      title: Sync - Multiple Files
      properties:
        files:
          type: array
          items:
            $ref: '#/components/schemas/FileInfo'
    StringResultType:
      type: string
      title: Text
    TablesResultType:
      type: object
      title: Tables
      properties:
        tables:
          type: array
          items:
            $ref: '#/components/schemas/ExtractedTable'
          description: Array of extracted tables from the document
      required:
        - tables
    TextBoxResultType:
      type: object
      title: Text Boxes
      properties:
        textBoxes:
          type: array
          items:
            $ref: '#/components/schemas/TextBox'
          description: Array of extracted text boxes from the document
      required:
        - textBoxes
    PIIResultType:
      type: object
      title: PII Boxes
      properties:
        PIIBoxes:
          type: array
          items:
            $ref: '#/components/schemas/PIIBox'
          description: Array of detected PII bounding boxes
      required:
        - PIIBoxes
    PropertiesTypes:
      title: Properties
      type: object
      properties:
        title:
          type: string
          description: The document's title
        author:
          type: string
          description: The document's author
        subject:
          type: string
          description: The document's subject
        keywords:
          type: string
          description: Document keywords
        creator:
          type: string
          description: The document's creator/application
        producer:
          type: string
          description: PDF document's producer or encoding software
        creationDate:
          type: string
          description: Document creation date in PDF date format
        modDate:
          type: string
          description: Document modification date in PDF date format
        trapped:
          type: string
          description: PDF trapped status
      required:
        - title
        - author
        - subject
        - keywords
        - creator
        - producer
        - creationDate
        - modDate
        - trapped
    FormResultType:
      type: object
      title: Form Fields
      properties:
        fields:
          type: array
          items:
            $ref: '#/components/schemas/FormField'
          description: Array of extracted form fields from the document
        averageConfidence:
          type: number
          format: float
          minimum: 0
          maximum: 100
          example: 96.5
          description: Average confidence score for all form fields
      required:
        - fields
        - averageConfidence
    JobError:
      type: object
      description: Error information if the job failed.
      properties:
        type:
          type: string
          example: PDFIsPasswordProtected
          enum:
            - BrokenDownloadURL
            - ConversionFailed
            - PDFIsPasswordProtected
        title:
          type: string
          example: PDF is password protected
    BadRequestProblemDetail:
      type: object
      description: Bad Request error details
      example:
        type: https://developers.gonitro.com/docs/build-nitro/errors#400-bad-request
        title: Bad Request
        status: 400
        detail: Request validation failed
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    UnauthorizedProblemDetail:
      type: object
      description: Unauthorized error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#401-unauthorized
        title: Unauthorized
        status: 401
        detail: Missing or invalid Authorization header
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    NotFoundProblemDetail:
      type: object
      description: Not Found error details
      example:
        type: https://developers.gonitro.com/docs/build-nitro/errors#404-not-found
        title: Not Found
        status: 404
        detail: Resource not found
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    ContentTooLargeProblemDetail:
      type: object
      description: Content too large error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#413-content-too-large
        title: Content too large
        status: 413
        detail: Uploaded document exceeds the file size limit
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    UnprocessableEntityProblemDetail:
      type: object
      description: Unprocessable Entity error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#422-unprocessable-entity
        title: Unprocessable Entity
        status: 422
        detail: The request was well-formed but could not be processed
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    InternalServerErrorProblemDetail:
      type: object
      description: Internal Server Error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#500-internal-server-error
        title: Internal Server Error
        status: 500
        detail: An unexpected error occurred
        instance: /platform/transformations
      allOf:
        - $ref: '#/components/schemas/ErrorResponse'
    FileInfo:
      type: object
      properties:
        URL:
          type: string
          format: uri
          description: >-
            URL with processed file for download. Field will be `null` if
            `delivery` parameter for post-processing upload is defined.
          nullable: true
        contentType:
          type: string
          description: The file type
          example: application/json
        metadata:
          type: object
          properties:
            fileSizeBytes:
              type: number
              nullable: true
            pageCount:
              type: number
              description: Number of pages in resulting document.
              nullable: true
    ExtractedTable:
      type: object
      properties:
        ID:
          type: string
          description: Unique identifier for the extracted table
        pageIndices:
          type: array
          items:
            type: integer
          description: Array of page indices where the table appears (0-based)
        tableData:
          $ref: '#/components/schemas/TableData'
      required:
        - ID
        - pageIndices
        - tableData
    TextBox:
      type: object
      properties:
        ID:
          type: string
          description: Unique identifier for the text box.
        text:
          type: string
          description: The extracted text content.
        textPiece:
          type: string
          nullable: true
          description: Specific piece of text.
        pageIndex:
          type: integer
          description: Page index where the text box was found (0-based).
        boundingBox:
          type: array
          items:
            type: number
          minItems: 4
          maxItems: 4
          description: >-
            Bounding box coordinates in points [x, y, width, height]. Check the
            [Bounding Box Guideline](/build-nitro/bounding-box).
          example:
            - 200
            - 100
            - 100
            - 20
      required:
        - ID
        - text
        - pageIndex
        - boundingBox
    PIIBox:
      type: object
      properties:
        ID:
          type: string
          description: >-
            A unique identifier for a PII detection group. Multiple individual
            PII entries can share the same ID, indicating they belong to the
            same group or type of PII.
          example: ccc05519-e71c-4226-bbff-72df3fb2d442
        text:
          type: string
          description: >-
            The complete text block that contains PII. For instance, the full
            text of an address spaning multiple content boxes.
          example: 10 Wall Street, NY 03183
        textPiece:
          type: string
          description: The specific piece of text identified as PII inside a box.
          example: 10 Wall Street
        pageIndex:
          type: integer
          description: Page index where the PII was found (0-based).
          example: 0
        boundingBox:
          type: array
          items:
            type: number
          minItems: 4
          maxItems: 4
          description: >-
            Bounding box coordinates in points [x, y, width, height]. Check the
            [Bounding Box Guideline](/build-nitro/bounding-box).
          example:
            - 200
            - 100
            - 100
            - 20
        PIIType:
          type: string
          description: Type of PII detected
          enum:
            - ADDRESS
            - AGE
            - AWS_ACCESS_KEY
            - AWS_SECRET_KEY
            - CREDIT_DEBIT_CVV
            - CREDIT_DEBIT_EXPIRY
            - CREDIT_DEBIT_NUMBER
            - DATE_TIME
            - DRIVER_ID
            - EMAIL
            - INTERNATIONAL_BANK_ACCOUNT_NUMBER
            - IP_ADDRESS
            - LICENSE_PLATE
            - MAC_ADDRESS
            - NAME
            - PASSWORD
            - PHONE
            - PIN
            - SWIFT_CODE
            - URL
            - USERNAME
            - VEHICLE_IDENTIFICATION_NUMBER
            - CA_HEALTH_NUMBER
            - CA_SOCIAL_INSURANCE_NUMBER
            - IN_AADHAAR
            - IN_NREGA
            - IN_PERMANENT_ACCOUNT_NUMBER
            - IN_VOTER_NUMBER
            - UK_NATIONAL_HEALTH_SERVICE_NUMBER
            - UK_NATIONAL_INSURANCE_NUMBER
            - UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER
            - BANK_ACCOUNT_NUMBER
            - BANK_ROUTING
            - PASSPORT_NUMBER
            - US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER
            - SSN
        confidence:
          type: number
          format: float
          minimum: 0
          maximum: 1
          description: Confidence score for the PII detection.
          example: 0.94
      required:
        - ID
        - text
        - textPiece
        - pageIndex
        - boundingBox
        - PIIType
        - confidence
    FormField:
      type: object
      properties:
        name:
          type: string
          description: The name of the form field.
        value:
          type: string
          description: The extracted value of the form field.
        confidence:
          type: number
          format: float
          minimum: 0
          maximum: 100
          example: 97.65
          description: Confidence score for the form field extraction.
      required:
        - name
        - value
        - confidence
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
          description: A URI reference that identifies the problem type
        title:
          type: string
          description: A short, human-readable summary of the problem type
        status:
          type: integer
          format: int32
          description: The HTTP status code
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence
    TableData:
      type: object
      properties:
        title:
          type: string
          description: The title of the table (if available)
        cells:
          type: array
          items:
            type: array
            items:
              oneOf:
                - type: string
                - type: number
          description: >-
            2D array representing table cell values. The first value index
            refers to the row, and the second the column.
        footers:
          type: array
          items:
            type: string
          description: Array of footer text/notes for the table.
        confidences:
          type: array
          items:
            type: array
            items:
              type: number
              format: float
              minimum: 0
              maximum: 1
          description: 2D array of confidence scores corresponding to each extracted cell.
        averageConfidence:
          type: number
          format: float
          minimum: 0
          maximum: 1
          description: Average confidence score for the entire table.
        headerCells:
          type: array
          items:
            type: array
            items:
              type: integer
            minItems: 2
            maxItems: 2
          description: >-
            Array of [row, column] coordinates identifying header cells
            (1-based)
        summaryCells:
          type: array
          items:
            type: array
            items:
              type: integer
            minItems: 2
            maxItems: 2
          description: >-
            Array of [row, column] coordinates identifying summary cells
            (1-based)
      required:
        - title
        - cells
        - footers
        - confidences
        - averageConfidence
        - headerCells
        - summaryCells
  responses:
    BadRequest:
      description: Bad Request - Invalid request parameters
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/BadRequestProblemDetail'
    Unauthorized:
      description: Unauthorized - Invalid or missing Authorization header
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/UnauthorizedProblemDetail'
    NotFound:
      description: Not Found - Resource not found
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/NotFoundProblemDetail'
    ContentTooLarge:
      description: Content Too Large - File size exceeds limit
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ContentTooLargeProblemDetail'
    UnprocessableEntity:
      description: Unprocessable Entity - Request cannot be processed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/UnprocessableEntityProblemDetail'
    InternalServerError:
      description: Internal Server Error - An unexpected error occurred
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/InternalServerErrorProblemDetail'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````