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

# Get the status of a nesting request

> Returns the current status of a nesting job and, once available, the `ResultIdentity` you use to fetch the result or an export.

Status values: `Queued` (accepted, waiting for a nester), `Running` (nesting now), `Completed` (finished — fetch the result or an export), `Failed` (errored — see `/v1/nesting/failures`).



## OpenAPI

````yaml /openapi.json get /v1/nesting/status
openapi: 3.0.0
info:
  title: NestAPI
  version: '1.0'
servers:
  - url: https://api.nestapi.com
    description: Production
security: []
tags:
  - name: account
    description: API key and account management
  - name: admin
  - name: ApiAdmin
  - name: auth
  - name: billing
  - name: fairness
    description: >-
      Per-customer nesting-minutes fairness config, weights and usage (requires
      an Admin API key)
  - name: importer
  - name: nesting
    description: Submit nesting jobs, retrieve results and exports
  - name: plan
  - name: proxy
  - name: public
    description: Health check and public utility endpoints
  - name: subscriptionstatus
paths:
  /v1/nesting/status:
    parameters:
      - $ref: '#/components/parameters/Accept'
    get:
      tags:
        - nesting
      summary: Get the status of a nesting request
      description: >-
        Returns the current status of a nesting job and, once available, the
        `ResultIdentity` you use to fetch the result or an export.


        Status values: `Queued` (accepted, waiting for a nester), `Running`
        (nesting now), `Completed` (finished — fetch the result or an export),
        `Failed` (errored — see `/v1/nesting/failures`).
      operationId: FetchNestingStatus
      parameters:
        - name: RequestId
          in: query
          description: >-
            The job to report on — the `RequestId` returned when you submitted
            the nest.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The current status of the job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NestingStatusResponse'
        '401':
          description: API key is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NestingStatusResponse'
      deprecated: false
      security:
        - Bearer: []
components:
  parameters:
    Accept:
      name: Accept
      in: header
      description: Accept Header
      required: true
      schema:
        type: string
        enum:
          - application/json
  schemas:
    NestingStatusResponse:
      title: NestingStatusResponse
      properties:
        RequestId:
          description: The job this status refers to.
          type: string
          nullable: false
        Status:
          description: One of `Queued`, `Running`, `Completed`, `Failed`.
          type: string
        ResultIdentity:
          description: >-
            The id of the completed result, once one is available; use it to
            fetch the result or an export. Null until the job completes.
          type: string
        Error:
          description: Error detail when the job has failed; otherwise null.
          type: string
        CompletedAt:
          description: When the job completed (UTC); null until it has.
          type: string
          format: date-time
      description: NestingStatusResponse
      type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````