Skip to main content
This walks through a complete DXF nest: authenticate, submit, and receive the result. It takes a few minutes and assumes you already have an API key.
1

Confirm your key works

curl https://dev.api.nestapi.com/auth/validate \
  -H "Authorization: Bearer YOUR_API_KEY"
A 200 with "Valid": true means you’re ready.
2

Prepare a webhook URL

Nesting is asynchronous. When a nest completes, NestAPI sends a POST with the result to a URL you supply as ResultsWebhookUri. For local testing, a tunnelling service (e.g. a request-bin or an ngrok URL) works well.See Webhooks for the payload format and how to secure the endpoint.
3

Submit the nesting request

POST /nesting accepts base64-encoded DXF files together with the sheets to nest onto and the nesting settings. It returns a RequestId immediately.
curl https://dev.api.nestapi.com/nesting \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Request": {
      "Parts":    [ /* base64 DXF parts + quantities */ ],
      "Sheets":   [ /* stock sheets: size + quantity */ ],
      "Settings": { /* spacing, rotations, etc. */ }
    },
    "ResultsWebhookUri": "https://your-app.example.com/hooks/nestapi",
    "AutomaticallyStartNesting": true
  }'
AutomaticallyStartNesting: true starts the nest immediately. Set it to false if you want to connect to SignalR for live progress first, then call /nesting/delayedstart — see the nesting workflow.
For the exact shape of Request (Base64NestingRequest) — parts, sheets, and every setting — see the Nesting section of the API Reference, and the parts & sheets and nesting settings concept pages.
4

Receive the result

When the nest finishes, NestAPI POSTs the ApiNestingResult to your webhook. It contains the layout, per-sheet placements, and material-usage figures.You can also fetch a result on demand once you have its RequestId:
curl "https://dev.api.nestapi.com/nesting/result/" \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "RequestId": "THE_REQUEST_ID" }'
5

Export the nest

Turn the completed nest into production output — DXF and reports:
curl "https://dev.api.nestapi.com/nesting/export?RequestId=THE_REQUEST_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
See export types for the available formats.

​
What next?

Nesting workflow

The full async model, SignalR, and delayed start.

Webhooks

Payload format, retries, and securing your endpoint.