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

# Get job by ID

> Get detailed information about a specific job by its ID.



## OpenAPI

````yaml /api-reference/openapi.json get /api/public/v2/jobs/{jobId}
openapi: 3.1.0
info:
  version: 2.0.0
  title: TitanX API
  description: |-
    # TitanX API Documentation

    Welcome to the TitanX API!

    ## Base URL

    ```
    https://app.titanx.io/api/public/v2
    ```

    ## Authentication

    All endpoints require Bearer token authentication:

    ```http
    Authorization: Bearer YOUR_API_KEY
    ```

    ## Response Format

    All endpoints return responses in this consistent format:

    ```json
    {
      "data": { /* Your requested data */ },
      "credits": {
        "creditsCharged": 5,
        "creditsRemaining": 995,
        "costPerPhone": 0.05,
        "phoneCount": 100
      },
      "error": null
    }
    ```
servers:
  - url: https://app.titanx.io
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: v2
    description: ✅ Version 2 API (Current)
    externalDocs:
      description: V2 API Guide
      url: https://docs.titanx.io/api/v2
  - name: v2-contacts
    description: V2 Contact operations - scoring and enrichment with credit tracking
  - name: v2-jobs
    description: V2 Job operations - job management and contact retrieval
  - name: v2-account
    description: V2 Account operations - credits and billing information
  - name: v2-webhooks
    description: >-
      V2 Webhook operations - manage webhook subscriptions for real-time contact
      event notifications
paths:
  /api/public/v2/jobs/{jobId}:
    get:
      tags:
        - v2
        - v2-jobs
      summary: Get job by ID
      description: Get detailed information about a specific job by its ID.
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: jobId
          in: path
      responses:
        '200':
          description: Successful response with job details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2JobDetailResponse'
        '404':
          description: Job not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - bearerAuth: []
components:
  schemas:
    V2JobDetailResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/JobSummary'
      required:
        - data
    JobSummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
        clientId:
          type: string
          format: uuid
        userId:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - Init
            - Pending
            - Mixed
            - Finalized
            - Rejected
            - QA
            - Canceled
        createdAt:
          type: string
          format: date-time
        jobSource:
          type: string
          enum:
            - app
            - api
        jobType:
          type: string
          enum:
            - scoring
            - enrichment
            - rescoring
            - score_enriched
            - enrich_rejected
            - enrich_final
            - titan_scoring
            - lightning_scoring
            - enrich_and_score
            - enrich_and_titan
            - enrich_score_rejected
            - enrich_titan_rejected
        name:
          type: string
      required:
        - id
        - clientId
        - userId
        - status
        - createdAt
        - jobSource
        - jobType
        - name
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````