{
  "openapi": "3.1.0",
  "info": {
    "title": "MachineSignal controlled B2B Italy order intake",
    "version": "2026-08-24.mini-dec-preview.v2",
    "description": "Zero-touch B2B Italy flow for MS-DEC-250 and its conditional MS-ACT-25 continuation. ACT is available only to the same buyer after a paid, completed DEC delivery and a signed entitlement for exactly 25 qualified records."
  },
  "externalDocs": {
    "description": "Lead opportunity score API, exact product fit, JSON output and machine-origin purchase path",
    "url": "https://machinesignal.it/api/lead-opportunity-score/"
  },
  "x-machinesignal-discovery-pages": [
    "https://machinesignal.it/it/prova/",
    "https://machinesignal.it/api/lead-opportunity-score/",
    "https://machinesignal.it/resources/lead-decision-api-b2b-italy/",
    "https://machinesignal.it/risorse/prioritizzazione-aziende-target-api/",
    "https://machinesignal.it/risorse/analisi-mercato-potenziale-api/"
  ],
  "servers": [
    {
      "url": "https://api.machinesignal.it"
    }
  ],
  "paths": {
    "/v1/previews/public-readiness": {
      "post": {
        "operationId": "createMachineSignalMiniDecPreview",
        "summary": "Compare one to three Italian B2B company domains with a limited DEC preview",
        "description": "Free, non-commercial comparison based only on observable public-homepage signals. It ranks only the submitted domains and illustrates part of the DEC method; it is not the paid MS-DEC-250 analysis, creates no order or checkout, accepts no personal data and does not persist submitted domains in the preview service.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PublicPreviewRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Limited DEC-method comparison and a synthetic DEC output illustration; no full commercial decision or side effect.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPreviewResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or missing confirmations.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Domain cannot be inspected safely or does not resolve to a public website.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Public preview rate limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/order-intents": {
      "post": {
        "operationId": "createMachineSignalOrderIntent",
        "summary": "Submit one DEC order or one entitled ACT continuation",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderIntentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Intent stored and zero-touch checkout creation queued. Keep order_tracking.order_receipt private and poll order_tracking.status_url.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderIntentAcceptedResponse"
                }
              }
            }
          },
          "202": {
            "description": "Intent stored and asynchronous checkout creation queued.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderIntentAcceptedResponse"
                }
              }
            }
          },
          "403": {
            "description": "Synthetic orders are forbidden on the public origin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Invalid or ineligible order intent.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Intake is fail-closed or temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/order-intents/{order_intent_id}": {
      "get": {
        "operationId": "getMachineSignalOrderIntentStatus",
        "summary": "Read authenticated order-intake status",
        "parameters": [
          {
            "name": "order_intent_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-MachineSignal-Order-Receipt",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Authenticated status. It may contain the buyer-specific checkout URL, post-payment dataset instructions, or an expiring artifact token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderStatusResponse"
                }
              }
            }
          },
          "404": {
            "description": "Order or receipt not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Status service temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/order-intents/{order_intent_id}/inputs": {
      "post": {
        "operationId": "submitMachineSignalPaidOrderInputs",
        "summary": "Submit up to 250 company-only targets after verified DEC payment",
        "parameters": [
          {
            "name": "order_intent_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-MachineSignal-Order-Receipt",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "targets"
                ],
                "properties": {
                  "targets": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 250,
                    "items": {
                      "$ref": "#/components/schemas/CompanyTarget"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Dataset accepted and fulfillment queued.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DatasetAcceptedResponse"
                }
              }
            }
          },
          "409": {
            "description": "Verified payment required or dataset conflict.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Dataset contains invalid or personal fields.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/order-intents/{order_intent_id}/artifact": {
      "get": {
        "operationId": "getMachineSignalPaidOrderArtifact",
        "summary": "Retrieve the completed DEC artifact or ACT campaign",
        "parameters": [
          {
            "name": "order_intent_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-MachineSignal-Order-Receipt",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-MachineSignal-Artifact-Token",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Purchased artifact.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArtifactResponse"
                }
              }
            }
          },
          "404": {
            "description": "Order, receipt, artifact, or token not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Artifact not ready, expired, or retrieval limit reached.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PublicPreviewRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "domains",
          "b2b_italy_confirmation",
          "company_only_confirmation",
          "privacy_acknowledged"
        ],
        "properties": {
          "domains": {
            "type": "array",
            "minItems": 1,
            "maxItems": 3,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "description": "Public company domain only; no people, email addresses, credentials or private hosts."
            }
          },
          "b2b_italy_confirmation": {
            "const": true
          },
          "company_only_confirmation": {
            "const": true
          },
          "privacy_acknowledged": {
            "const": true
          }
        }
      },
      "PublicPreviewFinding": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "check",
          "observed"
        ],
        "properties": {
          "check": {
            "type": "string"
          },
          "observed": {
            "oneOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          }
        }
      },
      "PublicPreviewResult": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "status",
          "domain",
          "public_readiness_score",
          "findings",
          "mini_dec_preview",
          "commercial_decision_generated",
          "full_dec_analysis_generated"
        ],
        "properties": {
          "status": {
            "enum": [
              "observed",
              "not_observed"
            ]
          },
          "domain": {
            "type": "string"
          },
          "public_readiness_score": {
            "oneOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              {
                "type": "null"
              }
            ]
          },
          "observed_title": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "observed_description": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicPreviewFinding"
            }
          },
          "mini_dec_preview": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/MiniDecPreview"
              },
              {
                "type": "null"
              }
            ]
          },
          "interpretation": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "commercial_decision_generated": {
            "const": false
          },
          "full_dec_analysis_generated": {
            "const": false
          }
        }
      },
      "MiniDecPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "rank",
          "opportunity_signal_score",
          "confidence",
          "priority",
          "decision",
          "reason",
          "evidence_coverage",
          "source_scope",
          "comparison_scope",
          "not_full_commercial_decision"
        ],
        "properties": {
          "rank": { "type": "integer", "minimum": 1, "maximum": 3 },
          "opportunity_signal_score": { "type": "integer", "minimum": 0, "maximum": 100 },
          "confidence": { "type": "number", "minimum": 0, "maximum": 0.65 },
          "priority": { "enum": ["high", "medium", "low"] },
          "decision": { "enum": ["prioritize_for_full_dec", "review_in_full_dec", "defer_until_more_evidence"] },
          "reason": { "type": "string" },
          "evidence_coverage": {
            "type": "object",
            "additionalProperties": false,
            "required": ["positive", "checked"],
            "properties": {
              "positive": { "type": "integer", "minimum": 0 },
              "checked": { "type": "integer", "minimum": 1 }
            }
          },
          "source_scope": { "const": "public_homepage_only" },
          "comparison_scope": { "const": "submitted_domains_only" },
          "not_full_commercial_decision": { "const": true }
        }
      },
      "PublicPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "protocol",
          "mode",
          "commercial_scope",
          "submitted_domain_count",
          "observed_domain_count",
          "results",
          "dec_illustration",
          "boundaries",
          "next_step"
        ],
        "properties": {
          "protocol": {
            "const": "machinesignal_mini_dec_preview_v2"
          },
          "mode": {
            "const": "free_limited_dec_preview"
          },
          "commercial_scope": {
            "const": "B2B_Italy_only"
          },
          "submitted_domain_count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 3
          },
          "observed_domain_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 3
          },
          "results": {
            "type": "array",
            "minItems": 1,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/PublicPreviewResult"
            }
          },
          "dec_illustration": {
            "type": "object",
            "additionalProperties": true
          },
          "boundaries": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
              "preview_is_full_ms_dec_250": {
                "const": false
              },
              "preview_is_limited_dec_method_illustration": {
                "const": true
              },
              "preview_ranks_only_submitted_domains": {
                "const": true
              },
              "order_created": {
                "const": false
              },
              "checkout_created": {
                "const": false
              },
              "payment_executed": {
                "const": false
              },
              "submitted_domains_persisted_by_preview": {
                "const": false
              }
            }
          },
          "next_step": {
            "type": "string"
          }
        }
      },
      "OrderIntentRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "buyer_business_name",
          "buyer_country",
          "buyer_vat_or_tax_identifier",
          "buyer_sdi_or_pec",
          "buyer_billing_address",
          "buyer_contact_email",
          "product_code",
          "price_eur",
          "stamp_duty_eur",
          "total_due_eur",
          "currency",
          "requested_outputs",
          "b2b_italy_confirmation",
          "terms_privacy_refund_acceptance",
          "onerous_clauses_specific_approval",
          "jurisdiction_forum",
          "buyer_authorizes_business_card_payment"
        ],
        "properties": {
          "buyer_business_name": {
            "type": "string",
            "minLength": 2
          },
          "buyer_country": {
            "const": "IT"
          },
          "buyer_vat_or_tax_identifier": {
            "type": "string",
            "minLength": 6
          },
          "buyer_sdi_or_pec": {
            "type": "string",
            "minLength": 6
          },
          "buyer_billing_address": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "line1",
              "postal_code",
              "city",
              "province",
              "country"
            ],
            "properties": {
              "line1": {
                "type": "string"
              },
              "postal_code": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "province": {
                "type": "string"
              },
              "country": {
                "const": "IT"
              }
            }
          },
          "buyer_contact_email": {
            "type": "string",
            "format": "email"
          },
          "product_code": {
            "enum": [
              "MS-DEC-250",
              "MS-ACT-25"
            ]
          },
          "price_eur": {
            "enum": [
              49,
              399
            ]
          },
          "stamp_duty_eur": {
            "enum": [
              0,
              2
            ]
          },
          "total_due_eur": {
            "enum": [
              49,
              401
            ]
          },
          "currency": {
            "const": "EUR"
          },
          "requested_outputs": {
            "enum": [
              250,
              25
            ]
          },
          "b2b_italy_confirmation": {
            "const": true
          },
          "terms_privacy_refund_acceptance": {
            "const": true
          },
          "onerous_clauses_specific_approval": {
            "const": true
          },
          "jurisdiction_forum": {
            "const": "Court of Milan, Italy"
          },
          "buyer_authorizes_business_card_payment": {
            "const": true
          },
          "source_product_code": {
            "const": "MS-DEC-250"
          },
          "source_order_intent_id": {
            "type": "string"
          },
          "source_delivery_id": {
            "type": "string"
          },
          "qualified_record_refs": {
            "type": "array",
            "minItems": 25,
            "maxItems": 25,
            "uniqueItems": true,
            "items": {
              "type": "string"
            }
          },
          "continuation_entitlement": {
            "type": "string",
            "minLength": 64
          }
        },
        "allOf": [
          {
            "if": {
              "properties": {
                "product_code": {
                  "const": "MS-DEC-250"
                }
              }
            },
            "then": {
              "properties": {
                "price_eur": {
                  "const": 49
                },
                "stamp_duty_eur": {
                  "const": 0
                },
                "total_due_eur": {
                  "const": 49
                },
                "requested_outputs": {
                  "const": 250
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "product_code": {
                  "const": "MS-ACT-25"
                }
              }
            },
            "then": {
              "required": [
                "source_product_code",
                "source_order_intent_id",
                "source_delivery_id",
                "qualified_record_refs",
                "continuation_entitlement"
              ],
              "properties": {
                "price_eur": {
                  "const": 399
                },
                "stamp_duty_eur": {
                  "const": 2
                },
                "total_due_eur": {
                  "const": 401
                },
                "requested_outputs": {
                  "const": 25
                }
              }
            }
          }
        ]
      },
      "CompanyTarget": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source_record_id",
          "domain",
          "company_name"
        ],
        "properties": {
          "source_record_id": {
            "type": "string",
            "minLength": 3,
            "maxLength": 160
          },
          "domain": {
            "type": "string",
            "description": "Public company domain; no URL credentials or personal data."
          },
          "company_name": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200
          },
          "sector_hint": {
            "type": "string",
            "maxLength": 160
          },
          "country_hint": {
            "type": "string",
            "default": "IT"
          }
        }
      },
      "OrderIntentAcceptedResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "order_intent_id",
          "product_code",
          "order_tracking"
        ],
        "properties": {
          "decision": {
            "type": "string"
          },
          "order_intent_id": {
            "type": "string",
            "pattern": "^order_intent_"
          },
          "product_code": {
            "enum": [
              "MS-DEC-250",
              "MS-ACT-25"
            ]
          },
          "order_status": {
            "type": "string"
          },
          "order_tracking": {
            "type": "object",
            "additionalProperties": true,
            "required": [
              "order_receipt",
              "status_url",
              "next_machine_action"
            ],
            "properties": {
              "order_receipt": {
                "type": "string",
                "description": "Private bearer receipt. Never log, publish or reuse it outside this order."
              },
              "status_url": {
                "type": "string",
                "format": "uri"
              },
              "next_machine_action": {
                "type": "string"
              },
              "checkout_handoff_status": {
                "type": "string"
              },
              "dataset_upload_authorized": {
                "type": "boolean"
              }
            }
          }
        }
      },
      "OrderStatusResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "decision",
          "order_intent_id",
          "product_code",
          "order_status",
          "payment_status",
          "fulfillment_status",
          "checkout_url_returned",
          "dataset_upload_authorized",
          "dataset_status",
          "artifact_ready",
          "duplicate",
          "next_machine_action",
          "normal_order_human_intervention_required",
          "updated_at"
        ],
        "properties": {
          "decision": {
            "const": "authenticated_real_zero_touch_order_status"
          },
          "order_intent_id": {
            "type": "string",
            "pattern": "^order_intent_"
          },
          "product_code": {
            "enum": [
              "MS-DEC-250",
              "MS-ACT-25"
            ]
          },
          "order_status": {
            "enum": [
              "accepted_checkout_queued",
              "checkout_ready",
              "paid_awaiting_dataset",
              "paid_dataset_received",
              "paid_processing",
              "paid_processing_act_campaign",
              "fulfilled",
              "failed_closed"
            ]
          },
          "payment_status": {
            "enum": [
              "unpaid",
              "paid_verified"
            ]
          },
          "invoice_status": {
            "enum": [
              "not_started",
              "created",
              "sdi_submitted",
              "sdi_processing",
              "accepted",
              "delivered",
              "not_delivered",
              "rejected",
              "discarded",
              "error"
            ]
          },
          "fulfillment_status": {
            "enum": [
              "awaiting_payment",
              "dataset_received",
              "evidence_processing",
              "completed"
            ]
          },
          "checkout_url_returned": {
            "type": "boolean"
          },
          "dataset_upload_authorized": {
            "type": "boolean"
          },
          "dataset_status": {
            "enum": [
              "not_received",
              "received",
              "purged",
              "not_applicable_predecessor_records_bound"
            ]
          },
          "artifact_ready": {
            "type": "boolean"
          },
          "duplicate": {
            "type": "boolean"
          },
          "next_machine_action": {
            "enum": [
              "poll_authenticated_status",
              "open_buyer_specific_checkout",
              "submit_company_inputs",
              "retrieve_artifact"
            ]
          },
          "checkout": {
            "$ref": "#/components/schemas/BuyerSpecificCheckout"
          },
          "dataset_upload": {
            "$ref": "#/components/schemas/DatasetUploadInstruction"
          },
          "artifact_release": {
            "$ref": "#/components/schemas/ArtifactReleaseInstruction"
          },
          "normal_order_human_intervention_required": {
            "const": false
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "BuyerSpecificCheckout": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url",
          "session_id",
          "expires_at",
          "buyer_specific"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://checkout\\.stripe\\.com/"
          },
          "session_id": {
            "type": "string",
            "pattern": "^cs_"
          },
          "expires_at": {
            "type": "integer"
          },
          "buyer_specific": {
            "const": true
          }
        }
      },
      "DatasetUploadInstruction": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "method",
          "path",
          "receipt_header",
          "max_company_records",
          "personal_data_forbidden"
        ],
        "properties": {
          "method": {
            "const": "POST"
          },
          "path": {
            "type": "string",
            "pattern": "^/v1/order-intents/order_intent_.+/inputs$"
          },
          "receipt_header": {
            "const": "X-MachineSignal-Order-Receipt"
          },
          "max_company_records": {
            "const": 250
          },
          "personal_data_forbidden": {
            "const": true
          }
        }
      },
      "ArtifactReleaseInstruction": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "path",
          "receipt_header",
          "artifact_token_header",
          "artifact_token",
          "expires_at",
          "max_retrievals"
        ],
        "properties": {
          "path": {
            "type": "string",
            "pattern": "^/v1/order-intents/order_intent_.+/artifact$"
          },
          "receipt_header": {
            "const": "X-MachineSignal-Order-Receipt"
          },
          "artifact_token_header": {
            "const": "X-MachineSignal-Artifact-Token"
          },
          "artifact_token": {
            "type": "string",
            "minLength": 64
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "max_retrievals": {
            "const": 3
          }
        }
      },
      "DatasetAcceptedResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "decision",
          "order_intent_id",
          "dataset_sha256",
          "target_count",
          "retention_expires_at",
          "duplicate",
          "raw_dataset_returned",
          "fulfillment_status"
        ],
        "properties": {
          "decision": {
            "const": "paid_order_dataset_accepted"
          },
          "order_intent_id": {
            "type": "string",
            "pattern": "^order_intent_"
          },
          "dataset_sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "target_count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 250
          },
          "retention_expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "duplicate": {
            "type": "boolean"
          },
          "raw_dataset_returned": {
            "const": false
          },
          "fulfillment_status": {
            "type": "string"
          }
        }
      },
      "DecisionEvidence": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "fact_type",
          "observed",
          "source_url",
          "observed_at",
          "content_sha256"
        ],
        "properties": {
          "fact_type": {
            "type": "string"
          },
          "observed": {
            "type": "boolean"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "content_sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        }
      },
      "DecisionRecord": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "source_record_id",
          "company_name",
          "domain",
          "opportunity_score",
          "confidence",
          "decision",
          "reason",
          "suggested_route",
          "evidence",
          "scoring_version"
        ],
        "properties": {
          "source_record_id": {
            "type": "string"
          },
          "company_name": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "opportunity_score": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "decision": {
            "enum": [
              "needs_verification",
              "discard",
              "watchlist",
              "nurture",
              "buy_deep_analysis"
            ]
          },
          "reason": {
            "type": "string"
          },
          "suggested_route": {
            "type": "string"
          },
          "evidence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DecisionEvidence"
            }
          },
          "page_snapshots": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "collection_errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "scoring_version": {
            "type": "string"
          }
        }
      },
      "DecDecisionArtifact": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "protocol",
          "job_id",
          "source_order_intent_id",
          "product_code",
          "record_count",
          "records",
          "scoring_version",
          "generated_at",
          "raw_html_retained",
          "provider_calls",
          "provider_writes"
        ],
        "properties": {
          "protocol": {
            "const": "machinesignal_evidence_result_v1"
          },
          "job_id": {
            "type": "string",
            "pattern": "^evidence_job_"
          },
          "source_order_intent_id": {
            "type": "string",
            "pattern": "^order_intent_"
          },
          "product_code": {
            "const": "MS-DEC-250"
          },
          "record_count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 250
          },
          "records": {
            "type": "array",
            "minItems": 1,
            "maxItems": 250,
            "items": {
              "$ref": "#/components/schemas/DecisionRecord"
            }
          },
          "scoring_version": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "raw_html_retained": {
            "const": false
          },
          "provider_calls": {
            "const": false
          },
          "provider_writes": {
            "const": false
          }
        }
      },
      "ActCampaignArtifact": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "contract_version",
          "mode",
          "product_code",
          "campaign_id",
          "source_delivery_id",
          "delivery_scope",
          "campaign_summary",
          "action_packs",
          "shared_campaign_controls",
          "side_effects",
          "generated_at"
        ],
        "properties": {
          "contract_version": {
            "type": "string"
          },
          "mode": {
            "const": "production_real_fulfillment"
          },
          "product_code": {
            "const": "MS-ACT-25"
          },
          "campaign_id": {
            "type": "string",
            "pattern": "^campaign_"
          },
          "source_delivery_id": {
            "type": "string"
          },
          "delivery_scope": {
            "type": "object",
            "additionalProperties": true
          },
          "campaign_summary": {
            "type": "object",
            "additionalProperties": true
          },
          "action_packs": {
            "type": "array",
            "minItems": 25,
            "maxItems": 25,
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "shared_campaign_controls": {
            "type": "object",
            "additionalProperties": true
          },
          "side_effects": {
            "type": "object",
            "additionalProperties": true
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "ArtifactResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "decision",
          "order_intent_id",
          "product_code",
          "artifact",
          "artifact_sha256"
        ],
        "properties": {
          "decision": {
            "enum": [
              "dec_artifact_retrieved",
              "act_campaign_retrieved"
            ]
          },
          "order_intent_id": {
            "type": "string",
            "pattern": "^order_intent_"
          },
          "product_code": {
            "enum": [
              "MS-DEC-250",
              "MS-ACT-25"
            ]
          },
          "artifact": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/DecDecisionArtifact"
              },
              {
                "$ref": "#/components/schemas/ActCampaignArtifact"
              }
            ],
            "description": "Purchased machine-readable DEC decisions or the entitled ACT campaign, typed according to the existing production fulfillment contracts."
          },
          "artifact_sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "description": "Fail-closed machine-readable error. No checkout, payment, invoice, dataset or artifact is released on failure.",
        "properties": {
          "decision": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-machinesignal-safety": {
    "live_product_chain": [
      "MS-DEC-250",
      "MS-ACT-25 post-purchase only"
    ],
    "b2b_italy_only": true,
    "free_public_preview_enabled": true,
    "free_public_preview_max_domains": 3,
    "free_public_preview_is_ms_dec_250": false,
    "free_public_preview_is_limited_dec_method_illustration": true,
    "free_public_preview_ranks_only_submitted_domains": true,
    "free_public_preview_persists_submitted_domains": false,
    "free_public_preview_creates_order_or_checkout": false,
    "public_checkout": false,
    "buyer_specific_checkout_after_validation": true,
    "dataset_upload_authorized_at_intake": false,
    "dataset_upload_authorized_after_verified_payment": true,
    "payment_executed_at_intake": false,
    "invoice_or_sdi_executed_at_intake": false,
    "invoice_and_sdi_automatic_after_verified_payment": true,
    "normal_order_human_intervention_required": false,
    "ms_act_25_requires_paid_completed_dec_entitlement": true,
    "ms_act_25_price_eur": 399,
    "ms_act_25_stamp_duty_eur": 2,
    "ms_act_25_total_due_eur": 401,
    "ms_act_25_target_count": 25
  }
}
