{
  "/campaigns/{cid}/eligibility": {
    "get": {
      "200": {
        "qualified_and_held": {
          "summary": "First-email qualification is not sending capacity or confirmed delivery",
          "value": {
            "observed_at": 1767240000.0,
            "complete": true,
            "inspected": 3,
            "total": 3,
            "counts": {"qualified": 1, "preparing": 0, "waiting": 1, "ineligible": 1, "contacted": 0, "stopped": 0, "needs_review": 0},
            "reason_counts": {"recontact_cooldown": 1, "catch_all_not_allowed": 1},
            "contacted_total": 0,
            "queued_followups": 0,
            "qualified_upper_bound": 1,
            "recontact_days": 30,
            "semantics": "first_email_qualification_not_send_capacity"
          }
        }
      }
    }
  },
  "/v1/billing/data-balance": {
    "get": {
      "200": {
        "pending_card_bonus": {
          "summary": "Only available money is spendable; adding a verified card earns the separate bonus without enabling top-up",
          "value": {
            "currency": "usd",
            "available_minor": 500,
            "promotional_minor": 500,
            "debt_minor": 0,
            "purchase_blocked": false,
            "signup_bonus": {"card_bonus_minor": 500, "card_bonus_state": "pending"}
          }
        }
      }
    }
  },
  "/billing/cards/{method}/remove": {
    "post": {
      "200": {
        "required_card_rejected": {
          "summary": "Original removal rejected before any effect; select another primary separately",
          "value": {
            "id": "example-remove-required",
            "method": "pm_exampleRequired",
            "revision": 7,
            "completed": false,
            "outcome": "rejected_no_effect",
            "reason": "subscription_replace_default_card_first",
            "replayed": false
          }
        },
        "same_rejection_after_response_loss": {
          "summary": "Same original remains rejected; replay does not attempt detachment",
          "value": {
            "id": "example-remove-required",
            "method": "pm_exampleRequired",
            "revision": 7,
            "completed": false,
            "outcome": "rejected_no_effect",
            "reason": "subscription_replace_default_card_first",
            "replayed": true
          }
        }
      }
    }
  },
  "/v1/data-jobs": {
    "post": {
      "202": {
        "queued_original": {
          "summary": "Synthetic accepted original with Location /v1/data-jobs/11111111111111111111111111111111. Recover by the same Idempotency-Key through /v1/data-jobs/by-key; read progress rather than submit another job. Staging and submission do not purchase or send.",
          "value": {
            "id": "11111111111111111111111111111111",
            "parameters": {
              "kind": "import_records",
              "import_id": "22222222222222222222222222222222",
              "expected_digest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "max_records": 1
            },
            "entity_type": "person",
            "state": "queued",
            "revision": 1,
            "counts": {
              "processed": 0,
              "created": 0,
              "added": 0,
              "removed": 0,
              "unchanged": 0,
              "invalid": 0,
              "newly_granted": 0,
              "already_owned": 0,
              "excluded": 0,
              "checked": 0,
              "changed": 0,
              "missing": 0
            },
            "total_rows": 1,
            "target_revision": null,
            "reason": null,
            "created_at": "2026-10-12T00:00:00Z",
            "updated_at": "2026-10-12T00:00:00Z",
            "expires_at": "2026-10-19T00:00:00Z",
            "completed_at": null,
            "policy": null,
            "amount_minor": 0,
            "funding_required_minor": 0,
            "pending_order_id": null
          }
        }
      }
    }
  },
  "/v1/data-jobs/{identity}/results": {
    "get": {
      "200": {
        "suppression_prefix": {
          "summary": "Synthetic committed suppression prefix. Recover each immutable receipt through /suppressions/operations/{suppression_operation_id}; duplicates cost zero and do not repeat audience cancellation. Job state owns remaining progress.",
          "value": {
            "items": [
              {
                "ordinal": 1,
                "key": "customer-one",
                "record_id": null,
                "outcome": "added",
                "reason": null,
                "suppression_operation_id": "import-11111111111111111111111111111111-1",
                "amount_minor": 0
              },
              {
                "ordinal": 2,
                "key": "duplicate",
                "record_id": null,
                "outcome": "unchanged",
                "reason": null,
                "suppression_operation_id": "import-11111111111111111111111111111111-2",
                "amount_minor": 0
              },
              {
                "ordinal": 3,
                "key": "bad-target",
                "record_id": null,
                "outcome": "invalid",
                "reason": "invalid_suppressions",
                "suppression_operation_id": null,
                "amount_minor": 0
              }
            ],
            "next_after": null
          }
        }
      }
    }
  },
  "/campaigns": {
    "post": {
      "200": {
        "empty_keyed_draft": {
          "summary": "Synthetic empty draft created with operation_id=create-empty. No contact, charge or send. After response loss, GET the original; an exact keyed replay returns this same receipt.",
          "value": {
            "operation": {
              "id": "create-empty",
              "workspace": "workspace",
              "campaign": "empty-draft",
              "action": "create",
              "request_digest": "48a409ab38799ab2dd66fc587789befc87153409b62f0029f32e6224e74928e5",
              "actor": "service:1074c3d56ba74f8c5bc2e4d260925e5fc9ec104cc000848b66289d0897c4942a",
              "expected_revision": null,
              "before_revision": null,
              "after_revision": 1,
              "outcome": "recorded",
              "state_after": "draft",
              "counts": {
                "contacts": 0,
                "added": 0,
                "excluded": 0
              },
              "recorded_at": 1791763200
            }
          }
        }
      }
    }
  },
  "/campaigns/{cid}/contacts": {
    "post": {
      "200": {
        "keyed_append": {
          "summary": "Synthetic keyed append. Recover this same receipt through draft-operations before replay; current contact totals are not this original.",
          "value": {
            "operation": {
              "id": "append-original",
              "workspace": "workspace",
              "campaign": "campaign",
              "action": "append",
              "request_digest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "actor": "service:example",
              "expected_revision": 1,
              "before_revision": 1,
              "after_revision": 2,
              "outcome": "recorded",
              "state_after": "draft",
              "counts": {
                "contacts": 2,
                "added": 1,
                "excluded": 0
              },
              "recorded_at": 1791763200
            }
          }
        },
        "unkeyed_append": {
          "summary": "Unkeyed append has counts, not an original operation. New clients should use operation_id.",
          "value": {
            "added": 1,
            "contacts": 2,
            "revision": 2
          }
        }
      }
    }
  },
  "/campaigns/{cid}/refills/{identity}": {
    "get": {
      "200": {
        "recovered_refill": {
          "summary": "Original after response loss; identical to POST, not another append. Invalid row content is absent.",
          "value": {
            "id": "refill-original",
            "campaign": "campaign",
            "added": 1,
            "duplicates": 1,
            "suppressed": 0,
            "conflicting": 0,
            "invalid": 1,
            "submitted": 3,
            "errors": [
              {
                "index": 2,
                "reason": "invalid_email"
              }
            ],
            "next_error_cursor": null,
            "audience_revision": 2,
            "send_budget_added_cents": 0,
            "send_budget_cents": null,
            "actor": "service:example",
            "created_at": 1791763200
          }
        }
      }
    }
  },
  "/campaigns/{cid}/draft-operations/{identity}": {
    "get": {
      "200": {
        "recovered_empty_draft": {
          "summary": "GET /campaigns/empty-draft/draft-operations/create-empty after lost Create response. Matches the original POST receipt, not current Campaign state. Missing original stays unknown; do not generate another operation ID.",
          "value": {
            "operation": {
              "id": "create-empty",
              "workspace": "workspace",
              "campaign": "empty-draft",
              "action": "create",
              "request_digest": "48a409ab38799ab2dd66fc587789befc87153409b62f0029f32e6224e74928e5",
              "actor": "service:1074c3d56ba74f8c5bc2e4d260925e5fc9ec104cc000848b66289d0897c4942a",
              "expected_revision": null,
              "before_revision": null,
              "after_revision": 1,
              "outcome": "recorded",
              "state_after": "draft",
              "counts": {
                "contacts": 0,
                "added": 0,
                "excluded": 0
              },
              "recorded_at": 1791763200
            }
          }
        }
      }
    }
  },
  "/v1/data-orders": {
    "post": {
      "202": {
        "awaiting_funds": {
          "summary": "Synthetic original awaiting data funds; GET does not resume it. Prices are examples, not client constants.",
          "value": {
            "id": "order-example",
            "state": "awaiting_funds",
            "policy": {
              "id": "fixture-person",
              "entity_type": "person",
              "currency": "usd",
              "unit_amount_minor": 2
            },
            "currency": "usd",
            "max_amount_minor": 100,
            "amount_minor": 0,
            "funding_required_minor": 2,
            "items": [],
            "matches": null,
            "created_at": "2026-10-11T00:00:00.000000Z",
            "completed_at": null,
            "automatic_funding": true,
            "funding_error": ""
          }
        },
        "matched_person_awaiting_funds": {
          "summary": "Synthetic matched person awaiting data funds; no licensed fields disclosed and no automatic continuation.",
          "value": {
            "id": "order-example",
            "state": "awaiting_funds",
            "policy": {
              "id": "fixture-person",
              "entity_type": "person",
              "currency": "usd",
              "unit_amount_minor": 2
            },
            "currency": "usd",
            "max_amount_minor": 100,
            "amount_minor": 0,
            "funding_required_minor": 2,
            "items": [],
            "matches": null,
            "created_at": "2026-10-11T00:00:00.000000Z",
            "completed_at": null,
            "automatic_funding": true,
            "funding_error": ""
          }
        },
        "matched_company_awaiting_funds": {
          "summary": "Synthetic matched company awaiting data funds; fixture price is illustrative, not a server constant.",
          "value": {
            "id": "order-example",
            "state": "awaiting_funds",
            "policy": {
              "id": "fixture-company",
              "entity_type": "company",
              "currency": "usd",
              "unit_amount_minor": 1
            },
            "currency": "usd",
            "max_amount_minor": 100,
            "amount_minor": 0,
            "funding_required_minor": 1,
            "items": [],
            "matches": null,
            "created_at": "2026-10-11T00:00:00.000000Z",
            "completed_at": null,
            "automatic_funding": true,
            "funding_error": ""
          }
        }
      }
    }
  },
  "/campaigns/{cid}/start-review": {
    "post": {
      "200": {
        "subscription": {
          "summary": "Synthetic funded subscription review; values are observations, not client constants.",
          "value": {
            "id": "review-original",
            "kind": "start",
            "commercial_policy_version": "startwave-core-v1",
            "spending_mode": "capacity",
            "schedule": {
              "definition": "campaign-pacing-upper-bound-v1",
              "observed_at": 1791633600,
              "local_date": "2026-10-10",
              "timezone": "America/New_York",
              "first_eligible_at": 1791633600,
              "opens_at": 1791604800,
              "closes_at": 1791691200,
              "nominal_gap_seconds": 1920,
              "daily_limit": 45,
              "quota_used": 0,
              "quota_remaining": 45,
              "pacing_slots_upper_bound": 30,
              "completion_guaranteed": false
            },
            "campaign": "campaign",
            "campaign_revision": 2,
            "capacity": {
              "quote_id": null,
              "capacity_operation": "in_original",
              "period_seconds": 2592000,
              "rate_cents_per_block": 3750,
              "rate_version": "subscription-30d-v1",
              "maximum_new_capacity_cents": 0,
              "daily_capacity": 90,
              "expires_at": 1794225540,
              "billing_mode": "subscription-30d-v1",
              "renewal": {
                "revision": 1,
                "enabled": true,
                "recurring_max_cents": 7500
              }
            },
            "audience_revision": 1,
            "remaining_send_count": 4,
            "state": "reviewed",
            "send_price_cents": 0,
            "send_budget_cents": 0,
            "audience_count": 2,
            "sequence_steps": 2,
            "send_committed_cents": 0,
            "reviewed_at": 1791633600,
            "reviewed_by": "service:example"
          }
        }
      }
    }
  },
  "/campaigns/{cid}/launch": {
    "post": {
      "200": {
        "started": {
          "summary": "Synthetic original launch receipt; started is not delivery.",
          "value": {
            "id": "launch-original",
            "campaign": "campaign",
            "state": "started",
            "campaign_revision": 3,
            "capacity_operation": "in_original",
            "send_price_cents": 0,
            "send_budget_cents": 0,
            "commercial_policy_version": "startwave-core-v1",
            "started_at": 1791633600
          }
        }
      }
    }
  },
  "/campaigns/{cid}/launches/{identity}": {
    "get": {
      "200": {
        "started": {
          "summary": "Recovery returns the same original, not a new launch.",
          "value": {
            "id": "launch-original",
            "campaign": "campaign",
            "state": "started",
            "campaign_revision": 3,
            "capacity_operation": "in_original",
            "send_price_cents": 0,
            "send_budget_cents": 0,
            "commercial_policy_version": "startwave-core-v1",
            "started_at": 1791633600
          }
        }
      }
    }
  },
  "/conversations": {
    "get": {
      "200": {
        "unread_reply": {
          "summary": "Synthetic list page; unread is an integer, next_cursor is nullable and not a total.",
          "value": {
            "items": [
              {
                "workspace": "one",
                "id": "conversation-example",
                "last_activity": 1791633600,
                "last_inbound_seq": 1,
                "status": "needs_reply",
                "revision": 2,
                "assignee": null,
                "archived": 0,
                "has_sent": 0,
                "email": "one@example.test",
                "campaign": "campaign-one",
                "campaign_name": "campaign-one",
                "unread": 1,
                "attention_seq": 1,
                "handoff": null,
                "inbox": {
                  "workflow": "needs_reply",
                  "reply_delivery": "none",
                  "intent": "needs_review"
                }
              }
            ],
            "next_cursor": null
          }
        }
      }
    }
  },
  "/conversations/{identity}": {
    "get": {
      "200": {
        "unread_reply": {
          "summary": "Synthetic inbound-only detail; optional source/classification fields are omitted when absent.",
          "value": {
            "conversation": {
              "workspace": "one",
              "id": "conversation-example",
              "last_activity": 1791633600,
              "last_inbound_seq": 1,
              "status": "needs_reply",
              "revision": 2,
              "assignee": null,
              "archived": 0,
              "has_sent": 0,
              "email": "one@example.test",
              "campaign": "campaign-one",
              "attention_seq": 1,
              "handoff": null,
              "inbox": {
                "workflow": "needs_reply",
                "reply_delivery": "none",
                "intent": "needs_review"
              },
              "unread": 1
            },
            "followups": {
              "state": "inactive",
              "next_eligible_at": null,
              "step": null,
              "stop_id": null,
              "stopped_at": null,
              "can_stop": false
            },
            "read_by": [],
            "read_by_more": false,
            "items": [
              {
                "seq": 1,
                "direction": "in",
                "authorship": "external",
                "occurred_at": 1791633600,
                "event_id": "one-a",
                "message_id": "<one@example.test>",
                "kind": "reply",
                "content": "Thanks",
                "intent": "needs_review",
                "revision": 1,
                "delivery_action": null,
                "delivery_status": null,
                "delivery_confidence": null,
                "participants": null
              }
            ],
            "next_cursor": null
          }
        },
        "unknown_reply": {
          "summary": "Synthetic unresolved outbound reply; retain the original job, never resubmit it under a new ID.",
          "value": {
            "conversation": {
              "workspace": "one",
              "id": "conversation-example",
              "last_activity": 1791633600,
              "last_inbound_seq": 1,
              "status": "needs_reply",
              "revision": 2,
              "assignee": null,
              "archived": 0,
              "has_sent": 0,
              "email": "one@example.test",
              "campaign": "campaign-one",
              "attention_seq": 1,
              "handoff": null,
              "inbox": {
                "workflow": "needs_reply",
                "reply_delivery": "unconfirmed",
                "intent": "needs_review"
              },
              "unread": 1
            },
            "followups": {
              "state": "inactive",
              "next_eligible_at": null,
              "step": null,
              "stop_id": null,
              "stopped_at": null,
              "can_stop": false
            },
            "read_by": [],
            "read_by_more": false,
            "items": [
              {
                "seq": 2,
                "direction": "out",
                "authorship": "human",
                "occurred_at": 1791633600,
                "job_id": "reply-original",
                "submitted_by": "service",
                "message_id": "<reply@example.test>",
                "state": "unknown",
                "error": "",
                "subject": "Re: Hello",
                "content": "Thanks for your reply.",
                "has_html": false,
                "attachments": []
              },
              {
                "seq": 1,
                "direction": "in",
                "authorship": "external",
                "occurred_at": 1791633600,
                "event_id": "one-a",
                "message_id": "<one@example.test>",
                "kind": "reply",
                "content": "Thanks",
                "intent": "needs_review",
                "revision": 1,
                "delivery_action": null,
                "delivery_status": null,
                "delivery_confidence": null,
                "participants": null
              }
            ],
            "next_cursor": null
          }
        }
      }
    }
  },
  "/inbox/review": {
    "get": {
      "200": {
        "unclassified": {
          "summary": "Synthetic intent review with unavailable classifier evidence; not an empty or successful classification.",
          "value": {
            "items": [
              {
                "event_id": "one-a",
                "intent": "needs_review",
                "revision": 1,
                "received_at": 1791633600,
                "conversation": "conversation-example",
                "status": "needs_reply",
                "conversation_revision": 2,
                "last_inbound_seq": 1,
                "attention_seq": 1,
                "archived": 0,
                "unread": 1,
                "email": "one@example.test",
                "campaign": "campaign-one",
                "campaign_name": "campaign-one",
                "classifier_state": null,
                "suggestion": null,
                "choice_confidence": null,
                "explicit_opt_out": null,
                "classifier_error": null,
                "classifier_updated_at": null,
                "classifier_origin": null,
                "reason": null,
                "probabilities": null
              }
            ],
            "next_cursor": null,
            "review_revision": 1
          }
        }
      }
    }
  }
}