Établi API docs

curl -sX POST https://api.etabli.io/v1/quotes/preview \  -H "Content-Type: application/json" \  -d '{"request":"Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box."}'

const response = await fetch("https://api.etabli.io/v1/quotes/preview", {  method: "POST",  headers: { "Content-Type": "application/json" },  body: JSON.stringify({    request: "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",  }),});const plan = await response.json();for (const leg of plan.legs) {  console.log(leg.key, leg.title, `${leg.questions.length} open questions`);}

import requests plan = requests.post(    "https://api.etabli.io/v1/quotes/preview",    json={"request": "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box."},    timeout=120,).json()for leg in plan["legs"]:    print(leg["key"], leg["title"], len(leg["questions"]), "open questions")

{  "title": "3,000 one-color logo mailer boxes, 3 warehouses",  "summary": "Produce 3,000 custom corrugated mailer boxes printed with the buyer's logo in one color, delivered split across warehouses in New Jersey, Texas and Nevada within 4 weeks, at up to $1.20 per box.",  "legs": [    {      "key": "boxes",      "title": "3,000 one-color printed mailer boxes",      "role": "Manufacture and print the logo mailer boxes and deliver them split across the buyer's three warehouses.",      "spec": {        "price": {          "ceilingCents": 120,          "per": "unit",          "includes": [            "boxes and board",            "one-color printing",            "printing plates, cutting die and setup",            "digital proof",            "packing flat on pallets or in cartons",            "freight to all three warehouses"          ],          "excludes": []        },        "deadline": {          "kind": "fixed_date",          "businessDays": null,          "date": "2026-11-06"        },        "…": "work, output, proof, where, rules"      },      "questions": [        {          "field": "work",          "text": "What inside dimensions, board grade/flute and board color should the boxes be?",          "suggestedAnswer": "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board."        }      ],      "inputsFrom": [],      "sourcing": {        "countries": [          "US"        ],        "…": "lookFor, searchTerms"      }    }  ],  "engine": "claude:claude-opus-5-5"}

curl -sX POST https://api.etabli.io/v1/quotes/preview \  -H "Content-Type: application/json" \  -d '{    "request": "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",    "answers": [      { "leg": "boxes", "field": "work", "text": "What inside dimensions, board grade/flute and board color should the boxes be?", "answer": "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board." },      { "leg": "boxes", "field": "rules.notes", "text": "Should the logo print on the outside only, and in which Pantone color?", "answer": "Outside only, lid top, Pantone Black C." }    ]  }'

curl -sX POST https://api.etabli.io/v1/projects \  -H "Content-Type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{    "request": "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",    "answers": [      { "leg": "boxes", "field": "work", "text": "What inside dimensions, board grade/flute and board color should the boxes be?", "answer": "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board." },      { "leg": "boxes", "field": "rules.notes", "text": "Should the logo print on the outside only, and in which Pantone color?", "answer": "Outside only, lid top, Pantone Black C." }    ],    "agent": { "name": "your-agent" }  }'

const response = await fetch("https://api.etabli.io/v1/projects", {  method: "POST",  headers: {    "Content-Type": "application/json",    "Idempotency-Key": crypto.randomUUID(), // a retry with the same key returns the same draft  },  body: JSON.stringify({    request: "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",    answers: [      { leg: "boxes", field: "work", text: "What inside dimensions, board grade/flute and board color should the boxes be?", answer: "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board." },      { leg: "boxes", field: "rules.notes", text: "Should the logo print on the outside only, and in which Pantone color?", answer: "Outside only, lid top, Pantone Black C." },    ],    agent: { name: "your-agent" },  }),});const { project, projectKey } = await response.json();console.log(project.next.message); // show the person this line, word for word// Keep projectKey (shown once): it reads this project later.

import uuid, requests draft = requests.post(    "https://api.etabli.io/v1/projects",    headers={"Idempotency-Key": str(uuid.uuid4())},    json={        "request": "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",        "answers": [            { "leg": "boxes", "field": "work", "text": "What inside dimensions, board grade/flute and board color should the boxes be?", "answer": "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board." },            { "leg": "boxes", "field": "rules.notes", "text": "Should the logo print on the outside only, and in which Pantone color?", "answer": "Outside only, lid top, Pantone Black C." },        ],        "agent": {"name": "your-agent"},    },    timeout=120,).json()print(draft["project"]["next"]["message"])  # show the person this line, word for wordproject_key = draft["projectKey"]  # keep it: shown once

{  "project": {    "id": "prj_01k7…",    "buyerId": null,    "status": "ready",    "claim": {      "status": "unclaimed",      "expiresAt": "… (7 days)",      "claimedAt": null    },    "draftedBy": {      "name": "your-agent",      "version": null    },    "next": {      "action": "show_claim_link",      "message": "Show the person this line: To check and publish your project, open https://etabli.io/claim#KQ7M-4TRD (or go to etabli.io/claim and enter KQ7M-4TRD) within 15 minutes. Nothing goes to workshops until they do.",      "url": "https://etabli.io/claim#KQ7M-4TRD",      "checkAfter": "… (10 minutes)"    },    "legs": [      {        "key": "boxes",        "tenderId": "tnd_…1",        "status": "ready",        "…": "spec, questions"      }    ]  },  "projectKey": "etb_live_prj_…",  "claim": {    "url": "https://etabli.io/claim#KQ7M-4TRD",    "code": "KQ7M-4TRD",    "codeExpiresAt": "… (15 minutes)"  }}

# Where it stands: `next` says what to do; Retry-After says when to look again (-i shows it).curl -si https://api.etabli.io/v1/projects/$PROJECT_ID -H "Authorization: Bearer $ETABLI_PROJECT_KEY" # What's happened since the last event you saw (oldest first).curl -s "https://api.etabli.io/v1/projects/$PROJECT_ID/events?after=$LAST_EVENT_ID" \  -H "Authorization: Bearer $ETABLI_PROJECT_KEY" # The code lapsed before the person opened it: a fresh one (the old one stops working).curl -sX POST https://api.etabli.io/v1/projects/$PROJECT_ID/claim-codes \  -H "Authorization: Bearer $ETABLI_PROJECT_KEY" -H "Content-Type: application/json" \  -d '{"ttlMinutes": 60}'

# Only after the person has said yes to sharing their name and email.curl -sX POST https://api.etabli.io/v1/quote-requests \  -H "Content-Type: application/json" \  -d '{    "request": "Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.",    "answers": [      { "leg": "boxes", "field": "work", "text": "What inside dimensions, board grade/flute and board color should the boxes be?", "answer": "9 x 6 x 3 in inside, 32 ECT E-flute, kraft board." },      { "leg": "boxes", "field": "rules.notes", "text": "Should the logo print on the outside only, and in which Pantone color?", "answer": "Outside only, lid top, Pantone Black C." }    ],    "name": "Their name",    "email": "them@example.com"  }'

# 1. Plan the request into legs; each leg is a tender with a spec and questions.curl -sX POST https://api.etabli.io/v1/projects \  -H "Authorization: Bearer $ETABLI_API_KEY" \  -H "Content-Type: application/json" \  -d '{"request":"Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box."}' # 2. Answer each leg's questions (or take the suggested answers).curl -sX POST https://api.etabli.io/v1/tenders/$TENDER_ID/answers \  -H "Authorization: Bearer $ETABLI_API_KEY" -H "Content-Type: application/json" \  -d '{"acceptSuggested": true}' # 3. Publish: every ready leg goes out to bid.curl -sX POST https://api.etabli.io/v1/projects/$PROJECT_ID/publish -H "Authorization: Bearer $ETABLI_API_KEY" # 4. Offers per leg, all-in (Établi's fee included).curl -s https://api.etabli.io/v1/projects/$PROJECT_ID/offers -H "Authorization: Bearer $ETABLI_API_KEY" # 5. Award: one contract per leg. Ask the person first: this commits real money.curl -sX POST https://api.etabli.io/v1/projects/$PROJECT_ID/award \  -H "Authorization: Bearer $ETABLI_API_KEY" -H "Content-Type: application/json" -d '{}'

# One customer's order, shipped to them.curl -sX POST https://api.etabli.io/v1/contracts/$CONTRACT_ID/orders \  -H "Authorization: Bearer $ETABLI_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: order-1042" \  -d '{    "quantity": 1,    "reference": "order-1042",    "address": { "name": "Sam Rivera", "line1": "100 Main St", "city": "Springfield", "region": "IL", "postalCode": "62701" }  }'

// One customer's order, shipped to them.const order = await fetch(`https://api.etabli.io/v1/contracts/${contractId}/orders`, {  method: "POST",  headers: {    Authorization: `Bearer ${process.env.ETABLI_API_KEY}`,    "Content-Type": "application/json",    "Idempotency-Key": "order-1042", // a retry never orders twice  },  body: JSON.stringify({    "quantity": 1,    "reference": "order-1042",    "address": {      "name": "Sam Rivera",      "line1": "100 Main St",      "city": "Springfield",      "region": "IL",      "postalCode": "62701"    }  }),}).then((response) => response.json());

REQUEST='Print 3,000 mailer boxes with our logo in one color, split across our warehouses in New Jersey, Texas and Nevada, within 4 weeks. Up to $1.20 a box.' curl -sX POST https://api.etabli.io/v1/quotes/preview \  -H "Content-Type: application/json" \  -d "$(jq -n --arg request "$REQUEST" '{request: $request}')" \  | jq '.legs[] | {key, title, questions: [.questions[] | {text, suggestedAnswer}]}' # Draft it for the person to claim, and print the line to show them. The saved# response holds the project key: keep the file out of git.curl -sX POST https://api.etabli.io/v1/projects \  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \  -d "$(jq -n --arg request "$REQUEST" '{request: $request}')" \  | tee .etabli-draft.json | jq -r '.project.next.message'