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

# Retrieve Usage Data Batch Job Status

> Get the status and results of a previously submitted usage data batch job by providing the job ID returned during submission.



## OpenAPI

````yaml get /api/v1/usage/job_status/{job_id}
openapi: 3.1.0
info:
  title: NinjaAPI
  version: 1.0.0
  description: ''
servers:
  - url: https://api.justpaid.io
security: []
paths:
  /api/v1/usage/job_status/{job_id}:
    get:
      summary: Retrieve Usage Data Batch Job Status
      description: >-
        Get the status and results of a previously submitted usage data batch
        job by providing the job ID returned during submission.
      operationId: loopfour_backend_external_api_usage_usage_data_job_status
      parameters:
        - in: path
          name: job_id
          schema:
            format: uuid
            title: Job Id
            type: string
          required: true
        - name: job_id
          in: path
          required: true
          schema:
            format: uuid
            type: string
          description: The UUID of the batch job.
      responses:
        '200':
          description: Successfully retrieved the batch job status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageDataBatchJobStatusResponseSchema'
              examples:
                job_in_progress:
                  summary: Job In Progress
                  value:
                    job_id: a4f8e9be-3d5b-4f8e-8b4d-9b4e5c9f5a2d
                    status: PROCESSING
                    created_at: '2023-10-10T10:00:00Z'
                    updated_at: '2023-10-10T10:02:00Z'
                    errors: null
                    info: null
                    total_events: 100
                job_completed:
                  summary: Job Completed Successfully
                  value:
                    job_id: b5g9f0cf-4e6c-5g9f-9c5e-0c5f6d0e6b3e
                    status: SUCCESS
                    created_at: '2023-10-10T09:00:00Z'
                    updated_at: '2023-10-10T09:05:00Z'
                    errors: []
                    info:
                      created_events: 98
                      duplicates:
                        - unique-key-3
                        - unique-key-7
                    total_events: 100
        '401':
          description: Unauthorized access due to invalid authentication.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                unauthorized:
                  summary: Unauthorized
                  value:
                    detail: Invalid authentication credentials.
        '404':
          description: Batch job not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                job_not_found:
                  summary: Job Not Found
                  value:
                    detail: Batch job with the provided ID does not exist.
        '500':
          description: Internal server error occurred.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              examples:
                server_error:
                  summary: Server Error
                  value:
                    detail: An unexpected error occurred.
      security:
        - HttpBearerAuth: []
components:
  schemas:
    UsageDataBatchJobStatusResponseSchema:
      properties:
        job_id:
          format: uuid
          title: Job Id
          type: string
        status:
          title: Status
          type: string
        created_at:
          format: date-time
          title: Created At
          type: string
        updated_at:
          format: date-time
          title: Updated At
          type: string
        errors:
          anyOf:
            - items: {}
              type: array
            - type: 'null'
          title: Errors
        info:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Info
        total_events:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Events
      required:
        - job_id
        - status
        - created_at
        - updated_at
      title: UsageDataBatchJobStatusResponseSchema
      type: object
  securitySchemes:
    HttpBearerAuth:
      type: http
      scheme: bearer

````