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

# Get Alignment Status

> The polled status of one alignment project.

Returns the state and its qualifiers only. Configuration, documents,
metrics, and failure qualifiers (degraded, stage_failures, error) never
change while a run executes or live on the detail route instead, so they
are not re-sent on every poll.



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json get /api/v3/alignment-projects/{alignment_id}/status
openapi: 3.1.0
info:
  title: Nugen Intelligence API
  description: >+
    Nugen Intelligence: Powering Specialized Intelligence At Scale.


    **Need an API key?** Sign up, log in to the platform and generate an API
    key.


    **Need help?** Sign up, log in to the platform and raise a support ticket.


    **What this API does.** Align models to your domain corpus and run them with

    confidence. Train-time alignment builds domain-aligned adaptors through

    proprietary methods spanning pre-training, supervised and reinforcement

    stages. Inference-time alignment quantifies uncertainty across the full

    generation trajectory, producing confidence scores and keeping every

    response on domain.


    **Workflow.** Upload documents, create or generate a benchmark, create an

    alignment project, receive an aligned model id. That one id serves chat

    completions, completions, embeddings and reranking, and its embeddings carry

    your domain's representation space, making retrieval domain aware. You
    define the success

    criteria for your domain; the platform handles the deep learning, the GPUs

    and the data preparation.


    **Authentication.** Every endpoint requires an API key sent as a Bearer
    token:

    `Authorization: Bearer <api_key>`.

  contact:
    name: Nugen Intelligence - Customer Support
    url: https://nugen.in/signup
    email: support@nugen.in
  version: 25.4.20
servers:
  - url: https://api.nugen.in
    description: Production
security: []
paths:
  /api/v3/alignment-projects/{alignment_id}/status:
    get:
      tags:
        - General
      summary: Get Alignment Status
      description: |-
        The polled status of one alignment project.

        Returns the state and its qualifiers only. Configuration, documents,
        metrics, and failure qualifiers (degraded, stage_failures, error) never
        change while a run executes or live on the detail route instead, so they
        are not re-sent on every poll.
      operationId: alignment_projects_status
      parameters:
        - name: alignment_id
          in: path
          required: true
          schema:
            type: string
            title: Alignment Id
      responses:
        '200':
          description: >-
            Returns the current status of an alignment project: state,
            timestamps, queue position and stop qualifier. Poll this; fetch the
            full record, including failure qualifiers, once from GET
            /alignment-projects/{alignment_id}.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlignmentStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    AlignmentStatusResponse:
      properties:
        alignment_id:
          type: string
          title: Alignment Id
          description: Unique identifier of the alignment project.
        status:
          $ref: '#/components/schemas/ResourceStatus'
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: Timestamp when the project was created.
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
          description: Timestamp when the project completed; null while still running.
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
          description: Last update timestamp.
        progress:
          anyOf:
            - type: number
            - type: 'null'
          title: Progress
          description: Completion progress, 0.0 to 100.0. Not wired up yet, always null.
        eta_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Eta Seconds
          description: Estimated time remaining in seconds. Not wired up yet, always null.
        queue_position:
          anyOf:
            - type: integer
            - type: 'null'
          title: Queue Position
          description: Place in the queue while status is QUEUED, 1 meaning next to start.
        stop_requested_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Stop Requested At
          description: Set once a stop was requested; the run ends STOPPED.
        early_deployable:
          type: boolean
          title: Early Deployable
          description: >-
            True once training has written a checkpoint, so POST
            /models/{model_id}/deployment?early=true will succeed. Only
            meaningful while status is still PROCESSING; false once training has
            finished, since a normal deploy applies then.
          default: false
      type: object
      required:
        - alignment_id
        - status
      title: AlignmentStatusResponse
      description: |-
        The polled view of one run: state, its qualifiers, nothing that never
        changes mid run. Configuration and documents live on the detail route.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ResourceStatus:
      type: string
      enum:
        - PROCESSING
        - READY
        - FAILED
        - DEPLOYING
        - EVALUATING
        - UNDEPLOYED
        - EVALUATED
        - STOPPED
        - QUEUED
      title: ResourceStatus
      description: >-
        Lifecycle status of a resource that runs asynchronously.


        - `QUEUED`: accepted and waiting its turn on a bounded queue

        - `PROCESSING`: training in progress

        - `READY`: training completed, ready for deployment

        - `DEPLOYING`: model being deployed for evaluation

        - `EVALUATING`: evaluation in progress

        - `UNDEPLOYED`: model being undeployed after evaluation

        - `EVALUATED`: evaluation completed, model undeployed

        - `STOPPED`: training stopped by the user before completion

        - `FAILED`: failed at any stage


        `QUEUED` is derived for the client at read time and never stored, so a

        resource read back later reports `PROCESSING` once execution has
        started.

        On input, values are case-insensitive and the legacy labels
        `p`/`PENDING`

        (PROCESSING), `c`/`COMPLETED` (READY) and `f` (FAILED) are still
        accepted.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````