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

# Check job status

<Panel>
  <Note>
    Cost: **free**
  </Note>
</Panel>

Retrieves the current status and results of a specific job by its job ID. This endpoint is essential for monitoring asynchronous job progress and retrieving results when jobs complete.

**This endpoint does not affect credits, but rate limits apply.**

<Note>
  For optimal performance, avoid excessive polling.
</Note>

<Warning>
  Job results are **available for 24 hours** after the job is completed.
</Warning>

### Job lifecycle

Jobs progress through the following states:

1. **`pending`**: job is created and queued for processing
2. **`processing`**: job is actively being executed
3. **`completed`**: job finished successfully with results available
4. **`failed`**: job encountered an error during execution


## OpenAPI

````yaml api-reference/openapi-0.yaml get /jobs/{jobId}
openapi: 3.1.0
info:
  title: Workfloows API
  version: '0'
  description: >
    ## Introduction


    This API provides a growing collection of powerful tools and endpoints 

    commonly used in automation workflows. It's designed for individual
    automators, 

    agencies, and app builders who want to streamline processes and connect
    systems.


    ## Authentication


    All requests require an API key, which must be included in the `x-api-key`
    header.


    ```

    x-api-key: <your_api_key>

    ```


    If the API key is missing or invalid, a `401 Unauthorized` response will be
    returned.
servers:
  - url: https://api.workfloo.ws/v0
security: []
paths:
  /jobs/{jobId}:
    get:
      tags:
        - Jobs
      summary: Get job status and results
      operationId: getJob
      parameters:
        - name: jobId
          in: path
          required: true
          schema:
            type: string
          description: The job identifier
          example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: Whether the request was successful
                      job:
                        type: object
                        properties:
                          id:
                            type: string
                            description: Job identifier
                          status:
                            type: string
                            enum:
                              - pending
                              - processing
                              - completed
                              - failed
                            description: Current job status
                          input:
                            type: object
                            description: Job input parameters (cleaned)
                      error:
                        type: string
                        description: Error message (only present for failed jobs)
                  results:
                    type: array
                    description: Job results (only present for completed jobs)
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Name of the similar company
                        url:
                          type: string
                          format: uri
                          description: Website URL of the similar company
                        description:
                          type: string
                          description: Short description of the company
                        similarity_score:
                          type: number
                          format: float
                          description: Similarity score (0-1, higher is more similar)
              examples:
                pending:
                  summary: Job pending
                  value:
                    response:
                      success: true
                      job:
                        id: 550e8400-e29b-41d4-a716-446655440000
                        status: pending
                        input:
                          url: https://workfloows.com
                          language: en
                processing:
                  summary: Job processing
                  value:
                    response:
                      success: true
                      job:
                        id: 550e8400-e29b-41d4-a716-446655440000
                        status: processing
                        input:
                          url: https://workfloows.com
                          language: en
                completed:
                  summary: Job completed
                  value:
                    response:
                      success: true
                      job:
                        id: 550e8400-e29b-41d4-a716-446655440000
                        status: completed
                        input:
                          url: https://workfloows.com
                          language: en
                    results:
                      - name: ExampleCorp
                        url: https://example.com/
                        description: >-
                          ExampleCorp is a mock company for demonstration
                          purposes in API documentation.
                        similarity_score: 0.95
                      - name: Mockify
                        url: https://mockify.example/
                        description: >-
                          Mockify provides sample automation tools for testing
                          and example workflows.
                        similarity_score: 0.87
                failed:
                  summary: Job failed
                  value:
                    response:
                      success: false
                      job:
                        id: 550e8400-e29b-41d4-a716-446655440000
                        status: failed
                        input:
                          url: https://workfloows.com
                          language: en
                      error: Failed to process similar companies
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: Access denied or job not owned by user
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                accessDenied:
                  summary: Access denied
                  value:
                    error: Access denied
        '404':
          description: Job not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                jobNotFound:
                  summary: Job not found
                  value:
                    error: Job not found
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - apiKeyAuth: []
components:
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
          examples:
            unauthorized:
              summary: Unauthorized
              value:
                error: Unauthorized.
            apiKeyRequired:
              summary: API Key required
              value:
                error: Unauthorized. API key is required.
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: An error occurred while processing your request.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````