Estimating email

Emails in your estimating mailbox, filed against the opportunity they concern.

Part of Opportunities in the register catalog.

Register ID

estimating_emailUse this name to ask for the register. The API calls it a shelf ID.

Each record is

An eventSomething that happened at a point in time.

Status

AvailableFilled today from connected systems, uploads or public data.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Microsoft 365 mail

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

20 fields: 16 required, 3 optional, 1 defined by each organisation.

Required

Every record carries these fields.

idText

Graph message id; the shelf's identity and dedup key.

Example: AAMkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx

received_atDate and timeISO 8601, with time zone

When the mailbox received the message.

Example: 2026-06-18T09:22:00Z

conversation_idText

Graph conversation/thread key.

Example: AAQkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx

subjectText

Subject line as received.

Example: ITT2529 Streetscape Upgrade - Mill & Currie Streets, Nambour

fromGroup of fields

Graph sender block (emailAddress.name, emailAddress.address).

source_folderText

Folder path the message was harvested from (Inbox, Local Council/Tweed Shire, …).

Example: Local Council/Sunshine Coast

has_attachmentsTrue or false

Whether the message carried attachments.

Example: true

attachmentsList

Attachment metadata only: id, name, content_type, size.

candidate_kindText

The ingress verdict: new_opportunity, chain_update or noise.

Example: new_opportunity

auto_createTrue or false

Whether the classification cleared the org's auto-create threshold with a folder name and an attachment.

Example: true

folder_name_suffixText

Proposed folder suffix for a new numbered opportunity folder.

Example: - ITT2529 Nambour Streetscape

classification_reasonText

Why the verdict came out that way, in one sentence.

Example: New tender invitation with specification attachment from …

description_candidateText

Cleaned subject as the candidate opportunity description.

Example: Streetscape Upgrade - Mill & Currie Streets, Nambour

email_idText

The harvested message's id the correction is about.

Example: AAMkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx

polarityText

suppress, promote or except.

Example: promote

reason_codeText

The selected reason, from a per-polarity vocabulary.

Example: new_tender_with_attachment

Optional

Present when the source system records them.

company_guessText

Best-effort company name from the sender domain; null for public webmail domains.

Example: Sunshine Coast Council

portal_link_detectedTrue or false

Whether a procurement-portal link was detected, meaning documents are not attached.

Example: false

confidenceNumberUnit: 0–1

Hand-tuned classifier confidence.

Example: 0.91

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

user_idNumber

The tenant identity that made the correction.

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

estimating_email.example.json

{
  "attachments": [
    {
      "content_type": "application/pdf",
      "id": "att-1",
      "name": "ITT2529_Specification.pdf",
      "size": 2458213
    }
  ],
  "auto_create": true,
  "candidate_kind": "new_opportunity",
  "classification_reason": "New tender invitation with specification attachment from a covered council domain.",
  "company_guess": "Sunshine Coast Council",
  "confidence": 0.91,
  "conversation_id": "AAQkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx",
  "description_candidate": "Streetscape Upgrade - Mill & Currie Streets, Nambour",
  "email_id": "AAMkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx",
  "folder_name_suffix": "- ITT2529 Nambour Streetscape",
  "from": {
    "emailAddress": {
      "address": "procurement@sunshinecoast.example.gov.au",
      "name": "Sunshine Coast Council Procurement"
    }
  },
  "has_attachments": true,
  "id": "AAMkAGJyZDEtZWMwMi00ZTY4LWE0ZjQtMDAwMDAwMDAwMDAx",
  "polarity": "promote",
  "portal_link_detected": false,
  "reason_code": "new_tender_with_attachment",
  "received_at": "2026-06-18T09:22:00Z",
  "source_folder": "Local Council/Sunshine Coast",
  "subject": "ITT2529 Streetscape Upgrade - Mill & Currie Streets, Nambour"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/estimating_email/v1.json

Show the full JSON Schema

Loading the schema…