tango-python 1.6.0__tar.gz → 1.7.0__tar.gz

{tango_python-1.6.0 → tango_python-1.7.0}/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.7.0] - 2026-09-23
+
+### Added
+- **Contract Disputes Act appeals** (Tango API 4.26.0). Two methods over the new `/api/contract_appeals/` resource: `list_contract_appeals()` and `get_contract_appeal()`, plus a `ContractAppeal` schema and the `CONTRACT_APPEALS_MINIMAL` / `CONTRACT_APPEALS_COMPREHENSIVE` defaults. These are decisions of the Civilian Board of Contract Appeals (CBCA) and the Armed Services Board of Contract Appeals (ASBCA) — appeals of a contracting officer's final decision under an existing contract, which is a different dispute from a bid protest and shares no identifiers with `list_protests()`. All ten of the API's filters are explicit named parameters.
+
+  Three behaviors are documented on the methods and the model, because each is otherwise a support question. **`decision_text` needs an Enterprise plan, and below that tier the key is absent rather than null** — read it with `.get()`. **Searching that text is free at every plan**: `search=` matches inside the decision body and returns no fragment of it, so buying the body does not change what you can find. And **`docket` accepts a docket as it is cited** — a leading `CBCA` / `ASBCA` and `No.` / `Nos.` are ignored, while commas stay part of a docket (`7092-C(6682, 6765, 6767)`) rather than separating two.
+
+  Neither default shape names `decision_text`: the body runs to roughly 100K characters, so putting it in a default would make every fetch ask for something most callers cannot read. `ordering="rank"` requires a non-empty `search`, matching the API.
+- **`alerts.contract_appeal.match` is an alertable event type.** `create_webhook_alert(query_type="contract_appeal", ...)` works. That method's `query_type` docstring now names the full current set and points at `list_webhook_event_types()` as the authority, since a list written into a docstring can only go stale.
+
+### Fixed
+- **`attachments(doc_role, doc_role_alt)` on opportunities and notices no longer raises `ShapeValidationError`.** The Tango API serves both fields on a Pro plan or above, but the SDK rejected them client-side after the request had already been made. `doc_role` says what an attachment is for (`requirement`, `instructions`, `pricing`, `terms`, `reference` or `unknown`) and `doc_role_alt` is a runner-up role that is usually null. Both must be named in the shape, since `attachments(*)` does not include them, and an attachment that has not been classified omits both keys, so read them with `.get()`.
+- **The shape overlay generator no longer lets one resource's view of a model hide fields from another's.** An opportunity is reachable both from `list_opportunities()` and as the `opportunity` expand on vehicles, and the vehicles embed exposes fewer attachment fields. Whichever tree was generated last replaced the other, so the opportunity schema lost fields its own endpoint serves. The generator now adds the missing fields instead of replacing the schema, and keeps every existing field's type as it was.
+- **SLED solicitations accept `delisted_at` and `meta(jurisdiction_declared)`.** Both were rejected client-side even though the API returns them. `delisted_at` is when a portal dropped a solicitation from its listing before its deadline, which is what `status_reason="delisted"` means. `meta.jurisdiction_declared` says whether the source stated the jurisdiction level itself or Tango classified it from the issuer's name. `delisted_at` is now in both `SLED_OPPORTUNITIES_MINIMAL` and `SLED_OPPORTUNITIES_COMPREHENSIVE`, matching the API's own list default.
+
+### Changed
+- **SLED response values now carry the types the API returns.** The SDK's SLED schema had guessed several types from field names. `posted_date`, `response_deadline`, `response_deadline_original` and `bid_opening_date` on `SledOpportunity` now parse to timezone-aware `datetime` values (before, `posted_date` and `bid_opening_date` were truncated to a `date` and the two deadlines stayed strings), as does `estimated_advertisement_date` on `SledForecast`. `estimated_value(min, max)` on forecasts now parses to `Decimal`. `category_codes` is typed as a list of `{scheme, code}` objects, `attachments` and `revisions` as lists, `meta(last_change_source_declared)` and `revisions(source_declared)` as booleans, and `attachments(size_bytes, pages)` and `revisions(sequence)` as integers. If you compared any of the date fields as strings, compare them as `datetime` values instead.
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.1.0) and regenerated `tango/shapes/generated_overlay.py`. The one resource the SDK does not wrap yet, `ebuy/requests`, is recorded in `contracts/shape_coverage_baseline.json` as a known gap.
+- The `ContractAppeal` shape schema is hand-curated in `tango/shapes/explicit_schemas.py` rather than left to the generated overlay. The generator falls back to name heuristics for a resource the live-API type probe has not sampled yet, and those heuristics get four of this resource's fields wrong: `docket_numbers` is a list, `listed` and `decision_date_repaired` are booleans, and `listing_year` is an integer.
+
+### Documentation
+- `list_protests()` and `docs/API_REFERENCE.md` now describe all three protest venues: GAO, the U.S. Court of Federal Claims (COFC) and the SBA Office of Hearings and Appeals (SBA OHA). `naics_code` is documented as the NAICS code at issue in an SBA OHA size or NAICS appeal, which GAO and COFC protests never carry, rather than the solicitation's code. `case_number` examples now cover each venue's format, and `naics_code` is listed among the filter parameters.
+- `docs/API_REFERENCE.md` documents the document-role fields on opportunity and notice attachments, and `delisted_at` and `meta.jurisdiction_declared` on SLED solicitations.
+- New **Contract Appeals** section in `docs/API_REFERENCE.md`, leading with what separates an appeal from a protest, plus the two new `ShapeConfig` constants in the shapes table.
+- Added `alerts.contract_appeal.match` to the event-type listing in `docs/WEBHOOKS.md`.
+
 ## [1.6.0] - 2026-09-10
 
 ### Added

{tango_python-1.6.0 → tango_python-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.6.0
+Version: 1.7.0
 Summary: Python SDK for the Tango API
 Project-URL: Homepage, https://github.com/makegov/tango-python
 Project-URL: Documentation, https://docs.makegov.com/tango-python

{tango_python-1.6.0 → tango_python-1.7.0}/docs/API_REFERENCE.md

@@ -22,6 +22,7 @@ Complete reference for all Tango Python SDK methods and functionality.
 - [Grants](#grants)
 - [GSA eLibrary Contracts](#gsa-elibrary-contracts)
 - [Protests](#protests)
+- [Contract Appeals](#contract-appeals)
 - [Budget](#budget)
 - [Business Types](#business-types)
 - [NAICS](#naics)
@@ -925,6 +926,25 @@ for opp in opportunities.results:
 - `naics_code` - Industry code
 - `psc_code` - Product/service code
 
+**Document roles — `attachments(doc_role, doc_role_alt)`:**
+
+On a **Pro plan or above**, each attachment can say what the document is for.
+`doc_role` is one of `requirement`, `instructions`, `pricing`, `terms`, `reference` or `unknown`; `doc_role_alt` is a runner-up role, and is null on nearly every attachment.
+
+```python
+opp = client.get_opportunity(
+    opportunity_id,
+    shape="opportunity_id,title,attachments(name,url,doc_role,doc_role_alt)",
+)
+for attachment in opp["attachments"]:
+    print(attachment["name"], attachment.get("doc_role"))
+```
+
+- **You have to name them.** `attachments(*)` does not include either field, and no default shape does.
+- **The keys are absent, not null**, on an attachment Tango has not classified. Use `attachment.get("doc_role")`.
+- A Free-plan request that names them gets the response without them, plus an entry in `meta.upgrade_hints`.
+- There is no filter on document role.
+
 ---
 
 ## Notices
@@ -1143,7 +1163,7 @@ contract = client.get_gsa_elibrary_contract("UUID_HERE")
 
 ## Protests
 
-Bid protest records (GAO, COFC, etc.).
+Bid protest records from three venues: GAO, the U.S. Court of Federal Claims (COFC), and the SBA Office of Hearings and Appeals (SBA OHA).
 
 ### list_protests()
 
@@ -1166,20 +1186,22 @@ protests = client.list_protests(
     filed_date_before=None,
     decision_date_after=None,
     decision_date_before=None,
+    naics_code=None,
     search=None,
 )
 ```
 
 **Filter Parameters:**
-- `source_system` - Filter by source system (e.g., `"gao"`)
+- `source_system` - Filter by source system: `"gao"`, `"cofc"`, or `"sba_oha"`
 - `outcome` - Filter by outcome (e.g., `"Denied"`, `"Dismissed"`, `"Withdrawn"`, `"Sustained"`)
 - `case_type` - Filter by case type
 - `agency` - Filter by protested agency
-- `case_number` - Filter by case number (e.g., `"b-423274"`)
+- `case_number` - Filter by base case number, matched case-insensitively (e.g., `"b-423274"` for GAO, `"26-1391"` for COFC, `"SIZ-6100"` for SBA OHA)
 - `solicitation_number` - Filter by solicitation number
 - `protester` - Search by protester name
 - `filed_date_after` / `filed_date_before` - Filed date range
 - `decision_date_after` / `decision_date_before` - Decision date range
+- `naics_code` - The NAICS code at issue in an SBA OHA size or NAICS appeal (e.g., `"541519"`). GAO and COFC protests carry no NAICS code, so this filter returns SBA OHA records only
 - `search` - Full-text search
 
 **Returns:** [PaginatedResponse](#paginatedresponse) with protest dictionaries
@@ -1214,6 +1236,85 @@ protest = client.get_protest(
 
 ---
 
+## Contract Appeals
+
+Contract Disputes Act appeal decisions from the Civilian Board of Contract Appeals (CBCA) and the Armed Services Board of Contract Appeals (ASBCA).
+
+**These are not bid protests.** A protest challenges an award or a solicitation before performance; an appeal here challenges a contracting officer's final decision under an existing contract — a claim, a termination, a differing-site-conditions dispute. Protests live at [Protests](#protests) and share no identifiers with this resource.
+
+One row is one decision as the board's own listing publishes it, so several fields describe the listing rather than the dispute. `listed` goes false once the board's newest listing stops carrying the decision; the row is kept, never dropped.
+
+### list_contract_appeals()
+
+List appeal decisions with filtering and shaping.
+
+```python
+appeals = client.list_contract_appeals(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.CONTRACT_APPEALS_MINIMAL,
+    # Filter parameters (all optional)
+    board=None,
+    docket=None,
+    appellant=None,
+    judge=None,
+    decision_type=None,
+    decision_date_after=None,
+    decision_date_before=None,
+    listed=None,
+    document_id=None,
+    search=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `board` - `"cbca"` or `"asbca"`; OR both with `"cbca|asbca"`
+- `docket` - Exact docket match, e.g. `"3288-R"`, `"59116"` or `"7092-C(6682, 6765, 6767)"`. A leading `CBCA` / `ASBCA` and `No.` / `Nos.` are ignored, so a docket can be pasted as it is cited. Commas are part of a docket, never a separator; OR several with `|`
+- `appellant` - Case-insensitive substring match on the appellant's name (min 2 characters)
+- `judge` - Case-insensitive exact match on the judge as the listing names them
+- `decision_type` - CBCA only: `"Decision"`, `"Dismissal"`, `"Order"`, `"Full Board Order"`, or the listing's own text. ASBCA rows carry no type
+- `decision_date_after` / `decision_date_before` - Decision date range (`YYYY-MM-DD`)
+- `listed` - Whether the board's newest listing still carries the decision
+- `document_id` - The board's own document id
+- `search` - Ranked full-text search over the appellant and the full decision text (min 2 characters); wrap in double quotes for a phrase
+- `ordering` - `decision_date` (the default, as `-decision_date`), `appellant`, `first_listed_at` or `rank`. `rank` requires a non-empty `search`
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with appeal-decision dictionaries
+
+**Example:**
+```python
+appeals = client.list_contract_appeals(
+    board="asbca",
+    search="differing site conditions",
+    decision_date_after="2025-01-01",
+    ordering="rank",
+    limit=25,
+)
+
+for appeal in appeals.results:
+    dockets = ", ".join(appeal["docket_numbers"])
+    print(f"{appeal['board'].upper()} {dockets}: {appeal['appellant']} ({appeal['decision_date']})")
+```
+
+### get_contract_appeal()
+
+Get a single decision by `uuid`.
+
+```python
+appeal = client.get_contract_appeal(
+    "DECISION_UUID",
+    shape=ShapeConfig.CONTRACT_APPEALS_COMPREHENSIVE,
+)
+```
+
+**Notes:**
+- `docket_numbers` is a list — the dockets with the board prefix stripped (`3288-R`, `59116`), and a consolidated appeal carries several. `docket_raw` keeps the listing's own text, and `docket_source` says where the dockets came from.
+- **Reading `decision_text` requires an Enterprise plan, and below that tier the key is absent rather than null** — read it with `.get()`, not `[...]`. Neither default shape names it: the body runs to roughly 100K characters, so asking for it on every row is rarely what you want.
+- **Searching that text is free at every plan.** `search=` matches inside the decision body and returns no fragment of it, so buying the body does not change what you can find.
+
+---
+
 ## State & Local (SLED)
 
 State, local and education procurement — solicitations that never appear on SAM.gov because they were never federal. **Beta**: coverage is partial and grows one jurisdiction at a time.
@@ -1323,6 +1424,8 @@ row = client.get_sled_opportunity(
 - `meta.attachment_count` can be **lower** than `len(row["attachments"])`. Some portals auto-generate a cover sheet alongside the real documents; it is listed and flagged `is_generated_summary`, but excluded from the count and from `has_documents`. The count answers "does this hold its solicitation package"; the array answers "what files exist".
 - `size_bytes` and `char_count` only mean something as a pair — 3 MB that yielded no characters is a scan awaiting OCR.
 - `raw(*)` needs a Small plan or above, and is explicitly unstable: its shape varies by portal platform.
+- `delisted_at` is when a portal dropped the solicitation from its listing before its deadline, and is what `status_reason="delisted"` means. It is null when the solicitation was never delisted or has been seen again since.
+- `meta.jurisdiction_declared` says whether the source stated the jurisdiction level itself. `False` means Tango classified it from the issuer's name, which is the common case on a state's central portal.
 
 **Reading a document body — `attachments(extracted_text)`:**
 
@@ -2206,12 +2309,14 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `SUBAWARDS_MINIMAL` | `list_subawards` | award_key, prime_recipient(uei,display_name), subaward_recipient(uei,display_name) |
 | `GSA_ELIBRARY_CONTRACTS_MINIMAL` | `list_gsa_elibrary_contracts` | uuid, contract_number, schedule, recipient(display_name,uei), idv(key,award_date) |
 | `PROTESTS_MINIMAL` | `list_protests` | case_id, case_number, title, source_system, outcome, filed_date |
+| `CONTRACT_APPEALS_MINIMAL` | `list_contract_appeals` | uuid, board, docket_numbers, decision_date, appellant, judge, decision_type, url |
+| `CONTRACT_APPEALS_COMPREHENSIVE` | `get_contract_appeal` | The list fields plus docket_raw, docket_source, decision_date_repaired, decision_type_raw, listing_year, first_listed_at, listed, text_status, text_char_count (omits `decision_text`, which needs an Enterprise plan) |
 | `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth |
 | `VEHICLE_ORDERS_MINIMAL` | `list_vehicle_orders` | key, piid, award_date, recipient(display_name,uei), total_contract_value, obligated |
 | `ITDASHBOARD_INVESTMENTS_MINIMAL` | `list_itdashboard_investments` | Minimal IT Dashboard investment fields |
 | `ITDASHBOARD_INVESTMENTS_COMPREHENSIVE` | `get_itdashboard_investment` | Full investment fields: uii, agency_code, agency_name, bureau_code, bureau_name, investment_title, type_of_investment, part_of_it_portfolio, updated_time, url |
-| `SLED_OPPORTUNITIES_MINIMAL` | `list_sled_opportunities` | opportunity_id, solicitation_number, solicitation_type, title, state, jurisdiction, agency, status, status_reason, posted_date, response_deadline, source_url, has_documents, first_seen_at, last_change_seen_at (no `description` — detail-only on the API) |
-| `SLED_OPPORTUNITIES_COMPREHENSIVE` | `get_sled_opportunity` | Full solicitation with description, the raw portal status, both deadlines, bid opening, category codes, and organization / contact / meta / attachments / revisions |
+| `SLED_OPPORTUNITIES_MINIMAL` | `list_sled_opportunities` | opportunity_id, solicitation_number, solicitation_type, title, state, jurisdiction, agency, status, status_reason, delisted_at, posted_date, response_deadline, source_url, has_documents, first_seen_at, last_change_seen_at (no `description` — detail-only on the API) |
+| `SLED_OPPORTUNITIES_COMPREHENSIVE` | `get_sled_opportunity` | Full solicitation with description, the raw portal status, the delisting timestamp, both deadlines, bid opening, category codes, and organization / contact / meta / attachments / revisions |
 | `SLED_REVISIONS_MINIMAL` | `list_sled_opportunity_revisions` | observed_at, sequence, kind, changed_fields, source_declared (omits `changes`, which needs a Small plan) |
 | `SLED_FORECASTS_MINIMAL` | `list_sled_forecasts` | forecast_id, state, agency, title, estimated_advertisement_date, estimated_advertisement_raw, procurement_category, procurement_method, contract_number, incumbent_name, source_url, estimated_value(*) |
 | `SLED_FORECASTS_COMPREHENSIVE` | `get_sled_forecast` | Full forecast with description, contract_term, mbe_dbe_goal, delivery_location, and organization / contact / estimated_value |

{tango_python-1.6.0 → tango_python-1.7.0}/docs/WEBHOOKS.md

@@ -88,6 +88,7 @@ tango webhooks list-event-types
 # alerts.dibbs_rfq.match     DLA DIBBS RFQ matched a saved alert
 # alerts.dibbs_rfp.match     DLA DIBBS RFP matched a saved alert
 # alerts.sled_opportunity.match  State/local/education solicitation matched a saved alert
+# alerts.contract_appeal.match  CBCA/ASBCA appeal decision matched a saved alert
 ```
 
 This list is served by the API, so it is always current — the SDK does not hardcode

{tango_python-1.6.0 → tango_python-1.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tango-python"
-version = "1.6.0"
+version = "1.7.0"
 description = "Python SDK for the Tango API"
 readme = "README.md"
 requires-python = ">=3.12"

{tango_python-1.6.0 → tango_python-1.7.0}/scripts/check_filter_shape_conformance.py

@@ -77,6 +77,7 @@ RESOURCE_TO_METHOD: dict[str, str | None] = {
     "sled/opportunities": "list_sled_opportunities",
     "sled/forecasts": "list_sled_forecasts",
     "protests": "list_protests",
+    "contract_appeals": "list_contract_appeals",
     "offices": "list_offices",
     "psc": "list_psc",
     "mas_sins": "list_mas_sins",

{tango_python-1.6.0 → tango_python-1.7.0}/scripts/check_shape_coverage.py

@@ -68,6 +68,7 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "budget/accounts": "BudgetAccount",
     "budget_accounts": "BudgetAccount",
     "protests": "Protest",
+    "contract_appeals": "ContractAppeal",
     "offices": "Office",
     "assistance_listings": "AssistanceListing",
     "business_types": "BusinessType",

{tango_python-1.6.0 → tango_python-1.7.0}/scripts/generate_shape_overlay.py

@@ -174,6 +174,20 @@ overlay: dict[str, dict[str, dict]] = {}
 report_rows: list[str] = []
 
 
+def put(container: str, name: str, e: dict) -> None:
+    """Record an overlay entry, unioning nested schemas when two resources reach the same container.
+
+    A model can be reached from its own resource and as another resource's expand (`opportunities` vs `vehicles.opportunity`), and those trees can expose different sub-fields.
+    Overwriting let a narrower embed hide fields the resource itself serves; the union only adds the missing ones, and the later entry still decides every field both trees define, so no existing type moves.
+    """
+    cur = overlay.setdefault(container, {}).get(name)
+    nested = {cur.get("nested") if cur else None, e.get("nested")}
+    if cur and None not in nested and "CodeDescription" not in nested and len(nested) == 2:
+        merged = {**nested_schemas[cur["nested"]], **nested_schemas[e["nested"]]}
+        e = {**e, "nested": intern_nested(re.sub(r"\d+$", "", e["nested"]), merged)}
+    overlay[container][name] = e
+
+
 def walk(res: str, path: str, node: dict, schema, container: str) -> None:
     if schema is None:
         return
@@ -182,7 +196,7 @@ def walk(res: str, path: str, node: dict, schema, container: str) -> None:
         for f in fields:
             if f != "*" and f not in schema:
                 t, lst = resolve_scalar(res, path, f)
-                overlay.setdefault(container, {})[f] = entry(t, True, lst)
+                put(container, f, entry(t, True, lst))
                 report_rows.append(f"{res}:{path or '(root)'}.{f}  ->  {t}{'[]' if lst else ''}")
     for ename, enode in (node.get("expands") or {}).items():
         fs = schema.get(ename)
@@ -192,7 +206,7 @@ def walk(res: str, path: str, node: dict, schema, container: str) -> None:
         if fs is None or child_schema is None:
             if is_wildcard(enode) and fs is not None:
                 continue
-            overlay.setdefault(container, {})[ename] = expand_entry(res, path, ename, enode)
+            put(container, ename, expand_entry(res, path, ename, enode))
             report_rows.append(f"{res}:{path or '(root)'}.{ename}  ->  expand")
         else:
             walk(res, child_path, enode, child_schema, container=nested_name)
@@ -214,7 +228,8 @@ for rkey, r in contract["resources"].items():
         for cname, cnode in (shape.get("expands") or {}).items():
             s[cname] = expand_entry(rkey, "", cname, cnode)
         if model_name:
-            overlay[model_name] = {**overlay.get(model_name, {}), **s}
+            for name, e in s.items():
+                put(model_name, name, e)
         continue
     walk(rkey, "", shape, schema, container=model_name)
 

{tango_python-1.6.0 → tango_python-1.7.0}/tango/__init__.py

@@ -10,6 +10,7 @@ from .exceptions import (
 )
 from .models import (
     BudgetAccount,
+    ContractAppeal,
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
@@ -53,7 +54,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.6.0"
+__version__ = "1.7.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -65,6 +66,7 @@ __all__ = [
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
+    "ContractAppeal",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",

{tango_python-1.6.0 → tango_python-1.7.0}/tango/client.py

@@ -24,6 +24,7 @@ from tango.models import (
     BudgetAccount,
     BusinessType,
     Contract,
+    ContractAppeal,
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
@@ -2592,18 +2593,18 @@ class TangoClient:
             shape: Response shape string (defaults to minimal shape)
             flat: If True, flatten nested objects in shaped response
             flat_lists: If True, flatten arrays using indexed keys
-            source_system: Filter by source system (e.g. gao)
+            source_system: Filter by source system: gao, cofc, or sba_oha
             outcome: Filter by outcome (e.g. Denied, Dismissed, Withdrawn, Sustained)
             case_type: Filter by case type
             agency: Filter by protested agency text
-            case_number: Filter by case number (e.g. b-423274)
+            case_number: Filter by base case number, matched case-insensitively (e.g. b-423274 for GAO, 26-1391 for COFC, SIZ-6100 for SBA OHA)
             solicitation_number: Filter by exact solicitation number
             protester: Filter by protester name text
             filed_date_after: Filed date on or after
             filed_date_before: Filed date on or before
             decision_date_after: Decision date on or after
             decision_date_before: Decision date on or before
-            naics_code: Filter by the solicitation's NAICS code (e.g. 541519)
+            naics_code: Filter by the NAICS code at issue in an SBA OHA size or NAICS appeal (e.g. 541519); GAO and COFC protests carry no NAICS code and never match
             search: Full-text search over protest searchable fields
         """
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
@@ -2682,6 +2683,141 @@ class TangoClient:
         data = self._get(f"/api/protests/{case_id}/", params)
         return self._parse_response_with_shape(data, shape, Protest, flat, flat_lists)
 
+    # ============================================================================
+    # Contract Disputes Act appeals (CBCA and ASBCA)
+    # ============================================================================
+
+    def list_contract_appeals(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        board: str | None = None,
+        docket: str | None = None,
+        appellant: str | None = None,
+        judge: str | None = None,
+        decision_type: str | None = None,
+        decision_date_after: str | None = None,
+        decision_date_before: str | None = None,
+        listed: bool | None = None,
+        document_id: str | None = None,
+        search: str | None = None,
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List Contract Disputes Act appeal decisions.
+
+        Decisions of the Civilian Board of Contract Appeals (CBCA) and the Armed
+        Services Board of Contract Appeals (ASBCA) — appeals of a contracting
+        officer's decision, which is a different dispute from a bid protest. For
+        protests, use :meth:`list_protests`.
+
+        Args:
+            page: Page number
+            limit: Results per page (max 100)
+            shape: Response shape string (defaults to minimal shape)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+            board: ``cbca`` or ``asbca``. Multi-value: ``cbca|asbca``
+            docket: Exact docket match, e.g. ``3288-R``, ``59116`` or
+                ``7092-C(6682, 6765, 6767)``. A leading ``CBCA`` / ``ASBCA`` and
+                ``No.`` / ``Nos.`` are ignored, so a docket can be pasted as it is
+                cited. Commas are part of a docket, never a separator; OR several
+                with ``|``
+            appellant: Case-insensitive substring match on the appellant's name
+                (min 2 characters)
+            judge: Case-insensitive exact match on the judge as the listing names
+                them
+            decision_type: CBCA only — ``Decision``, ``Dismissal``, ``Order``,
+                ``Full Board Order``, or the listing's own text where it matches
+                none of those. ASBCA rows carry no type
+            decision_date_after: Decided on or after (YYYY-MM-DD)
+            decision_date_before: Decided on or before (YYYY-MM-DD)
+            listed: Whether the board's newest listing still carries the decision.
+                ``False`` returns the ones it has dropped, which are kept here
+                rather than deleted
+            document_id: The board's own document id
+            search: Ranked full-text search over the appellant and the full
+                decision text (min 2 characters). Wrap in double quotes for a
+                phrase. Free at every plan, and it returns no fragment of the
+                text — only reading ``decision_text`` needs Enterprise
+            ordering: Sort field — ``decision_date`` (the default, as
+                ``-decision_date``), ``appellant``, ``first_listed_at`` or
+                ``rank``. ``rank`` requires a non-empty ``search``
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.CONTRACT_APPEALS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("board", board),
+            ("docket", docket),
+            ("appellant", appellant),
+            ("judge", judge),
+            ("decision_type", decision_type),
+            ("decision_date_after", decision_date_after),
+            ("decision_date_before", decision_date_before),
+            ("listed", listed),
+            ("document_id", document_id),
+            ("search", search),
+            ("ordering", ordering),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/contract_appeals/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, ContractAppeal, flat, flat_lists)
+            for item in data["results"]
+        ]
+
+        return PaginatedResponse(
+            count=data["count"],
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+            meta=data.get("meta"),
+        )
+
+    def get_contract_appeal(
+        self,
+        appeal_id: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single Contract Disputes Act appeal decision by uuid.
+
+        Args:
+            appeal_id: Decision UUID
+            shape: Response shape string (defaults to the comprehensive shape)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+        """
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.CONTRACT_APPEALS_COMPREHENSIVE
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/contract_appeals/{appeal_id}/", params)
+        return self._parse_response_with_shape(data, shape, ContractAppeal, flat, flat_lists)
+
     # ============================================================================
     # DLA DIBBS (RFQs, RFPs, awards)
     # ============================================================================
@@ -4733,7 +4869,10 @@ class TangoClient:
         Args:
             name: Human-readable name for this alert.
             query_type: One of ``opportunity``, ``contract``, ``idv``, ``ota``,
-                ``otidv``, ``entity``, ``grant``, ``forecast``.
+                ``otidv``, ``entity``, ``grant``, ``forecast``, ``exclusion``,
+                ``dibbs_rfq``, ``dibbs_rfp``, ``sled_opportunity`` or
+                ``contract_appeal``. :meth:`list_webhook_event_types` is the
+                current authority — this list can only go stale.
             filters: Dict of query parameters that the alert matches against
                 (e.g. ``{"naics": "541330", "set_aside": "SBA"}``).
             frequency: ``realtime`` | ``daily`` | ``weekly`` | ``custom``.