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

# 1D Nesting Request

> This endpoint requires calling with your ApiKey <br />



## OpenAPI

````yaml /openapi.json post /v1/nesting/1D
openapi: 3.0.0
info:
  title: NestAPI
  version: '1.0'
servers:
  - description: Staging
    url: https://dev.api.nestapi.com
security: []
tags:
  - name: account
    description: API key and account management
  - name: ApiAdmin
  - name: auth
  - 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: public
    description: Health check and public utility endpoints
paths:
  /v1/nesting/1D:
    parameters:
      - $ref: '#/components/parameters/Accept'
    post:
      tags:
        - nesting
      summary: 1D Nesting Request
      description: This endpoint requires calling with your ApiKey <br />
      operationId: NestingRequest1D
      parameters:
        - name: Request
          in: query
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NestingRequest1D'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Nesting1DResponse'
      deprecated: false
      security:
        - Bearer: []
components:
  parameters:
    Accept:
      name: Accept
      in: header
      description: Accept Header
      required: true
      schema:
        type: string
        enum:
          - application/json
  schemas:
    NestingRequest1D:
      title: NestingRequest1D
      properties:
        Request:
          $ref: '#/components/schemas/Nesting1DRequest'
      description: >-
        Submit a 1D (linear) nesting request for bar, tube, or profile stock.
        Returns the optimised cutting plan synchronously in the response.
      type: object
    Nesting1DResponse:
      title: Nesting1DResponse
      properties:
        ResponseStatus:
          type: string
        StatusReport:
          type: string
        Result:
          $ref: '#/components/schemas/Nesting1DResult'
      description: Nesting1DResponse
      type: object
    Nesting1DRequest:
      title: Nesting1DRequest
      properties:
        SourceLength:
          type: number
          format: double
          nullable: false
        SourceWidth:
          type: number
          format: double
          nullable: false
        CutGap:
          type: number
          format: double
          nullable: false
        SourceQuantity:
          type: integer
          format: int32
          nullable: false
        ComputationTime:
          type: integer
          format: int32
          nullable: false
        Lengths:
          type: array
          items:
            $ref: '#/components/schemas/Nesting1DRequestLength'
      description: Nesting1DRequest
      type: object
    Nesting1DResult:
      title: Nesting1DResult
      properties:
        NumberOfUniqueNests:
          type: integer
          format: int32
          nullable: false
        Nests:
          type: array
          items:
            $ref: '#/components/schemas/Nesting1DNest'
      description: Nesting1DResult
      type: object
    Nesting1DRequestLength:
      title: Nesting1DRequestLength
      properties:
        Quantity:
          type: integer
          format: int32
          nullable: false
        Length:
          type: number
          format: double
          nullable: false
      description: Nesting1DRequestLength
      type: object
    Nesting1DNest:
      title: Nesting1DNest
      properties:
        Multiplicity:
          type: integer
          format: int32
          nullable: false
        PlacedLengths:
          type: array
          items:
            $ref: '#/components/schemas/Nesting1DPlacedLength'
      description: Nesting1DNest
      type: object
    Nesting1DPlacedLength:
      title: Nesting1DPlacedLength
      properties:
        Quantity:
          type: integer
          format: int32
          nullable: false
        Length:
          type: number
          format: double
          nullable: false
        PlacedX:
          type: number
          format: double
          nullable: false
      description: Nesting1DPlacedLength
      type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````