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

# Get eligible delivery windows for order

> Find delivery windows available for a specific order based on the order's store location and requirements. Requires either order_id or external_order_id. Optionally filter by time range and requested capacity.



## OpenAPI

````yaml get /v1/eligible_delivery_windows
openapi: 3.1.0
info:
  title: Nash API
  version: 1.0.0
servers:
  - url: https://api.sandbox.usenash.com
    description: Sandbox API
  - url: https://api.sandbox.ap-southeast-2.usenash.com
    description: Sandbox API (Australia)
  - url: https://api.usenash.com
    description: Production API
  - url: https://api.ap-southeast-2.usenash.com
    description: Production API (Australia)
security: []
tags:
  - name: Notifications
    description: Notifications
    x-nash-topic: config
  - name: Annotate
    description: Annotate
    x-nash-topic: wismo
  - name: Notifications — Send
    description: One-off notification send without a NotificationTrigger.
    x-nash-topic: notifications
  - name: Shipping
    description: Shipping operations
    x-nash-topic: shipping
  - name: Workflow
    description: Workflow automation management
    x-nash-topic: scheduling
  - name: Workflow Execution
    description: Workflow execution history and monitoring
    x-nash-topic: scheduling
  - name: Optimization Strategies
    description: Create, read, update, and delete route optimization strategies.
    x-nash-topic: scheduling
  - name: AI Agents
    description: AI agent management — create, read, update, and delete agents
    x-nash-topic: config
  - name: AI Functions
    description: LLM-backed domain tools
    x-nash-topic: ai
  - name: Webhooks
    description: Webhook delivery inspection
    x-nash-topic: webhooks
  - name: Miscellaneous
    description: Miscellaneous
  - name: Job
    description: Job
    x-nash-topic: wismo
  - name: Batch Job
    description: Batch Job
    x-nash-topic: wismo
  - name: Order
    description: Order
    x-nash-topic: wismo
  - name: Route
    description: Route
    x-nash-topic: scheduling
  - name: Provider
    description: Provider
    x-nash-topic: provider
  - name: Dispatch Strategies
    description: Dispatch Strategies
    x-nash-topic: scheduling
  - name: Store Locations
    description: Store Locations
    x-nash-topic: config
  - name: Vehicles
    description: Vehicles
    x-nash-topic: provider
  - name: Couriers
    description: Couriers
    x-nash-topic: provider
  - name: Shifts
    description: Shifts
    x-nash-topic: provider
  - name: Delivery Windows
    description: Delivery Windows
    x-nash-topic: config
  - name: Templates
    description: Templates
    x-nash-topic: config
  - name: Zones
    description: Zones
    x-nash-topic: config
  - name: Feedback
    description: Feedback
    x-nash-topic: reporting
  - name: Organizations
    description: Organizations
    x-nash-topic: config
  - name: Store Catalog
    description: Store Catalog
    x-nash-topic: config
  - name: Messaging
    description: Messaging
    x-nash-topic: config
  - name: Contracts
    description: Provider contract pricing and version listings
    x-nash-topic: provider
  - name: Event Timeline
    description: Entity-scoped event timeline + outbound provider traffic for one entity.
    x-nash-topic: internal
  - name: Fleet
    description: Inbound endpoints fleets call to update in-flight deliveries.
    x-nash-topic: delivery
  - name: Route Restrictions
    description: Org-scoped geographic areas the route optimizer must avoid traversing.
    x-nash-topic: config
  - name: Users
    description: User, role, and organization-membership management.
    x-nash-topic: config
paths:
  /v1/eligible_delivery_windows:
    get:
      tags:
        - Delivery Windows
      summary: Get eligible delivery windows for order
      description: >-
        Find delivery windows available for a specific order based on the
        order's store location and requirements. Requires either order_id or
        external_order_id. Optionally filter by time range and requested
        capacity.
      operationId: get_eligible_delivery_windows_v1_eligible_delivery_windows_get
      parameters:
        - name: orderId
          in: query
          description: The order for which to return eligible delivery windows.
          required: false
          schema:
            title: Orderid
            anyOf:
              - type: string
              - type: 'null'
            description: The order for which to return eligible delivery windows.
            default: null
            example: ord_1234567890
          example: ord_1234567890
        - name: externalOrderId
          in: query
          description: The external order id for which to return eligible delivery windows.
          required: false
          schema:
            title: Externalorderid
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The external order id for which to return eligible delivery
              windows.
            default: null
            example: ext_1234567890
          example: ext_1234567890
        - name: startTime
          in: query
          description: The range start for delivery windows.
          required: true
          schema:
            title: Starttime
            type: string
            description: The range start for delivery windows.
            format: date-time
            example: '2024-10-06T00:00:00Z'
          example: '2024-10-06T00:00:00Z'
        - name: endTime
          in: query
          description: The range end for delivery windows.
          required: true
          schema:
            title: Endtime
            type: string
            description: The range end for delivery windows.
            format: date-time
            example: '2024-10-07T00:00:00Z'
          example: '2024-10-07T00:00:00Z'
        - name: requestedCapacity
          in: query
          description: Optionally specify the requested capacity for the delivery windows.
          required: false
          schema:
            title: Requestedcapacity
            anyOf:
              - type: number
              - type: 'null'
            description: >-
              Optionally specify the requested capacity for the delivery
              windows.
            default: null
            example: 10
          example: 10
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EligibleDeliveryWindowsResponse'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NashValidationError'
components:
  schemas:
    EligibleDeliveryWindowsResponse:
      title: EligibleDeliveryWindowsResponse
      required:
        - eligibleDeliveryWindows
        - ineligibleDeliveryWindows
      type: object
      properties:
        eligibleDeliveryWindows:
          title: Eligibledeliverywindows
          type: array
          items:
            $ref: '#/components/schemas/EligibleDeliveryWindow'
        ineligibleDeliveryWindows:
          title: Ineligibledeliverywindows
          type: array
          items:
            $ref: '#/components/schemas/EligibleDeliveryWindow'
      description: Response for the eligible delivery windows endpoint.
    NashValidationError:
      title: NashValidationError
      required:
        - error
        - response_status
        - RequestID
      type: object
      properties:
        error:
          $ref: '#/components/schemas/NashErrorDetails'
        response_status:
          title: Response Status
          type: string
        RequestID:
          title: Requestid
          type: string
    EligibleDeliveryWindow:
      title: EligibleDeliveryWindow
      required:
        - id
        - ineligibleReason
        - allowedTags
        - startTime
        - startTimeLocal
        - endTime
        - endTimeLocal
      type: object
      properties:
        id:
          title: Id
          type: string
          description: The id of the delivery window
        name:
          title: Name
          anyOf:
            - type: string
            - type: 'null'
          description: The name of the delivery window
          default: null
          example: S21
        ineligibleReason:
          title: Ineligiblereason
          anyOf:
            - type: string
            - type: 'null'
          description: The ineligibility failure reason
          example: Ineligible due to order tags
        allowedTags:
          title: Allowedtags
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          description: The list of allowed tags
          example: '[''rapid'', ''oversize'']'
        storeLocationId:
          title: Storelocationid
          anyOf:
            - type: string
            - type: 'null'
          description: The id of the store location object
          default: null
          example: stl_1234567890
        storeLocationExternalId:
          title: Storelocationexternalid
          anyOf:
            - type: string
            - type: 'null'
          description: The external id of the store location object, if applicable
          default: null
          example: '1001'
        zoneId:
          title: Zoneid
          anyOf:
            - type: string
            - type: 'null'
          description: The id of the zone object
          default: null
          example: zone_1234567890
        zoneExternalId:
          title: Zoneexternalid
          anyOf:
            - type: string
            - type: 'null'
          description: The external id of the zone object, if applicable
          default: null
          example: '1001'
        cutoffTime:
          title: Cutofftime
          anyOf:
            - type: string
            - type: 'null'
          description: The cutoff time of the delivery window in UTC
          example: '2024-10-04T00:00:00.000000'
        cutoffTimeLocal:
          title: Cutofftimelocal
          anyOf:
            - type: string
            - type: 'null'
          description: The cutoff time of the delivery window in local timezone
          example: '2024-10-04T00:00:00.000000'
        startTime:
          title: Starttime
          anyOf:
            - type: string
            - type: 'null'
          description: The start time of the delivery window in UTC
          example: '2024-10-06T00:00:00.000000'
        startTimeLocal:
          title: Starttimelocal
          anyOf:
            - type: string
            - type: 'null'
          description: The start time of the delivery window in local timezone
          example: '2024-10-06T00:00:00.000000'
        endTime:
          title: Endtime
          anyOf:
            - type: string
            - type: 'null'
          description: The end time of the delivery window in UTC
          example: '2024-10-07T00:00:00.000000'
        endTimeLocal:
          title: Endtimelocal
          anyOf:
            - type: string
            - type: 'null'
          description: The end time of the delivery window in local timezone
          example: '2024-10-07T00:00:00.000000'
        remainingCapacity:
          title: Remainingcapacity
          anyOf:
            - type: number
            - type: 'null'
          description: The remaining capacity for the delivery window
          default: null
          example: 10
        maximumCapacity:
          title: Maximumcapacity
          anyOf:
            - type: number
            - type: 'null'
          description: The maximum capacity for the delivery window
          default: null
          example: 10
        minimumOrderValueCents:
          title: Minimumordervaluecents
          anyOf:
            - type: integer
            - type: 'null'
          description: The minimum order value for the delivery window in cents
          default: null
          example: 1000
        timezoneId:
          title: Timezoneid
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The timezone id of the return timestamps, following the TZ database
            format
          default: null
          example: America/New_York
        priceCents:
          title: Pricecents
          anyOf:
            - type: integer
            - type: 'null'
          description: The price for the delivery window in cents
          default: null
          example: 1000
        score:
          title: Score
          anyOf:
            - type: number
            - type: 'null'
          description: The score for the delivery window
          default: null
          example: 1
        windowMetadata:
          title: Windowmetadata
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          description: Key-value window metadata.
          default: null
          example:
            key: value
    NashErrorDetails:
      title: NashErrorDetails
      required:
        - code
        - message
      type: object
      properties:
        code:
          title: Code
          type: string
        message:
          title: Message
          type: string
        details:
          title: Details
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null

````