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

# Get background job status

> Poll the status of a background job started by `POST /api/v1/push`.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/jobs/{jobId}
openapi: 3.0.0
info:
  contact:
    email: support@linguolink.dev
    name: LinguLink Support
  description: Translation management API for LinguLink platform
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: LinguLink API v1
  version: 1.0.0
servers:
  - description: Development server
    url: http://localhost:3000
  - description: Production server
    url: https://linguolink.dev
security: []
tags:
  - description: API key authentication and validation
    name: Authentication
  - description: API key management operations
    name: API Keys
  - description: Translation management operations
    name: Translations
  - description: Endpoints the `lingulink` CLI's pull/push commands call
    name: CLI
  - description: Project metadata and translation coverage
    name: Projects
paths:
  /api/v1/jobs/{jobId}:
    get:
      tags:
        - Projects
      summary: Get background job status
      description: Poll the status of a background job started by `POST /api/v1/push`.
      operationId: getJob
      parameters:
        - description: Background job ID returned by POST /api/v1/push
          in: path
          name: jobId
          required: true
          schema:
            type: string
          example: 5f6e8b2a-3b7a-4c2a-9c37-8e6f8d6a9b10
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  createdAt: '2024-11-10T17:30:00.000Z'
                  errorMessage: null
                  id: 5f6e8b2a-3b7a-4c2a-9c37-8e6f8d6a9b10
                  projectId: 5f9c2b9e-3b7a-4c2a-9c37-8e6f8d6a9b10
                  status: completed
                  summary:
                    created: 40
                    updated: 88
                  type: import
                  updatedAt: '2024-11-10T17:30:05.000Z'
              schema:
                type: object
          description: Job status and summary.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - BearerAuth: []
        - OAuth2: []
components:
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Bad request
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Authentication required
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Resource not found
    InternalServerError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Internal server error
  schemas:
    Error:
      properties:
        details:
          description: Additional error details (development only)
          type: string
        error:
          description: Error message
          type: string
        timestamp:
          description: Error timestamp
          format: date-time
          type: string
      required:
        - error
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API Key
      description: 'Enter your API key in the format: Bearer <api_key>'
      scheme: bearer
      type: http
    OAuth2:
      description: >-
        Exchange your API key (as client_secret) for a short-lived access token.
        The playground fetches and applies the token automatically.
      flows:
        clientCredentials:
          scopes:
            admin: Administrate translations and API keys
            export:read: Export translations
            translations:read: Read translations
            translations:write: Create or update translations
          tokenUrl: https://linguolink.dev/api/v1/auth/token
      type: oauth2

````