Skip to main content

Quotes

Create Quote​

POST /public/v1/quotes

Headers:

  • X-Public-API-Key: <key>
  • Idempotency-Key: <uuid>

Body:

{
  "product_id": "stickers",
  "quantity": 250,
  "options": {},
  "ship_to": {
    "name": "Ada Lovelace",
    "company": "Example Co",
    "line1": "123 Main St",
    "line2": null,
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US",
    "phone": "+14155551212",
    "email": "ada@example.com"
  }
}

Example:

curl -sS \
  -X POST \
  -H "X-Public-API-Key: $FIELDKIT_PUBLIC_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"stickers","quantity":250}' \
  "https://api.fieldkit.cc/public/v1/quotes"

Response:

{
  "id": "6e6d1c7a-8b0a-4a73-9e3a-0f24b1e6d7c0",
  "status": "pending",
  "expires_at": "2026-02-09T19:00:00Z",
  "product": {
    "id": "stickers",
    "name": "Stickers"
  },
  "quantity": 250,
  "options": null,
  "pricing": {
    "subtotal": 0,
    "tax": 0,
    "shipping": 0,
    "total": 0,
    "currency": "usd",
    "line_items": []
  },
  "ship_to": null,
  "shipping_rates": [],
  "selected_shipping_rate_id": null,
  "artwork": []
}

Get Quote​

GET /public/v1/quotes/{quote_id}

curl -sS \
  -H "X-Public-API-Key: $FIELDKIT_PUBLIC_API_KEY" \
  "https://api.fieldkit.cc/public/v1/quotes/<quote_id>"

Response:

{
  "id": "6e6d1c7a-8b0a-4a73-9e3a-0f24b1e6d7c0",
  "status": "pending",
  "expires_at": "2026-02-09T19:00:00Z",
  "product": {
    "id": "stickers",
    "name": "Stickers"
  },
  "quantity": 250,
  "options": null,
  "pricing": {
    "subtotal": 0,
    "tax": 0,
    "shipping": 0,
    "total": 0,
    "currency": "usd",
    "line_items": []
  },
  "ship_to": null,
  "shipping_rates": [],
  "selected_shipping_rate_id": null,
  "artwork": []
}

Create Artwork Upload​

Create an upload session and attach an artwork record to the quote.

POST /public/v1/quotes/{quote_id}/artwork-uploads

Headers:

  • X-Public-API-Key: <key> (or Authorization: Bearer <token>)
  • Idempotency-Key: <uuid>

Body:

{
  "file_name": "artwork.pdf",
  "file_type": "application/pdf",
  "size_bytes": 123456
}

Example:

curl -sS \
  -X POST \
  -H "X-Public-API-Key: $FIELDKIT_PUBLIC_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"artwork.pdf","file_type":"application/pdf","size_bytes":123456}' \
  "https://api.fieldkit.cc/public/v1/quotes/<quote_id>/artwork-uploads"

Response:

{
  "upload_url": "https://uploads.example.com",
  "artwork_id": "bfa90869-5d72-4ee7-93bb-15d3f0b6d5a3",
  "upload_token": "..."
}