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

# Get job status

> Check whether a job is still building, partially ready, fully ready, or failed.



## OpenAPI

````yaml GET /job/{job_id}
openapi: 3.1.0
info:
  title: ShareSame API
  description: >-
    Build and remix websites from your own AI using ShareSame's job-based
    generation API.
  version: '2026-03-13'
servers:
  - url: https://{host}/api/sharesame
    variables:
      host:
        default: your-base-url-from-sharesame
        description: Base URL ShareSame gives your team when API access is enabled
security:
  - bearerAuth: []
paths:
  /job/{job_id}:
    get:
      summary: Poll a job
      description: >-
        Check whether a job is still building, partially ready, fully ready, or
        failed.
      parameters:
        - name: job_id
          in: path
          description: The job ID returned by POST /generate
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Current job status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
components:
  schemas:
    JobStatusResponse:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - building
            - partial
            - ready
            - failed
        files:
          type: array
          items:
            $ref: '#/components/schemas/GenerateFile'
        error:
          type: string
        progress:
          type: string
        elapsed_seconds:
          type: integer
        sandbox_session:
          type: string
        deployment_id:
          type: string
          description: Deployment snapshot ID when available
    GenerateFile:
      type: object
      required:
        - path
        - content
      properties:
        path:
          type: string
          description: Project-relative file path
        content:
          type: string
          description: Full file contents
        language:
          type: string
          default: text
          description: Best-effort language label
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````