tango-python 1.7.0__py3-none-any.whl → 1.9.0__py3-none-any.whl

tango/__init__.py

@@ -3,6 +3,7 @@
 from .client import TangoClient
 from .exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -14,7 +15,11 @@ from .models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyAttachment,
+    EbuyRequest,
     Exclusion,
+    FederalRegisterDocument,
     GsaElibraryContract,
     ITDashboardInvestment,
     PaginatedResponse,
@@ -54,19 +59,24 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.7.0"
+__version__ = "1.9.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
     "TangoAuthError",
     "TangoNotFoundError",
     "TangoValidationError",
+    "TangoAttachmentLinkError",
     "TangoRateLimitError",
     "RateLimitInfo",
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
     "ContractAppeal",
+    "FederalRegisterDocument",
+    "EbuyAccess",
+    "EbuyAttachment",
+    "EbuyRequest",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",

tango/client.py

@@ -5,12 +5,13 @@ import warnings
 from datetime import date, datetime
 from decimal import Decimal
 from typing import Any, Literal, cast
-from urllib.parse import urljoin
+from urllib.parse import quote, urljoin
 
 import httpx
 
 from tango.exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -28,8 +29,11 @@ from tango.models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyRequest,
     Entity,
     Exclusion,
+    FederalRegisterDocument,
     Forecast,
     Grant,
     GsaElibraryContract,
@@ -174,55 +178,57 @@ class TangoClient:
             self._last_response_headers = response.headers
             self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
 
-            if response.status_code == 401:
-                raise TangoAuthError(
-                    "Invalid API key or authentication required", response.status_code
-                )
-            elif response.status_code == 404:
-                raise TangoNotFoundError("Resource not found", response.status_code)
-            elif response.status_code == 400:
-                error_data = response.json() if response.content else {}
-                error_msg = "Invalid request parameters"
-                if error_data:
-                    # Try to extract a more specific error message
-                    if isinstance(error_data, dict):
-                        detail = (
-                            error_data.get("detail")
-                            or error_data.get("message")
-                            or error_data.get("error")
-                        )
-                        if detail:
-                            error_msg = f"Invalid request parameters: {detail}"
-                        issues = error_data.get("issues")
-                        if isinstance(issues, list):
-                            rejected = [
-                                f"{issue['path']} ({issue['reason']})"
-                                if issue.get("reason")
-                                else str(issue["path"])
-                                for issue in issues
-                                if isinstance(issue, dict) and issue.get("path")
-                            ]
-                            if rejected:
-                                error_msg = f"{error_msg}: {', '.join(rejected)}"
-                raise TangoValidationError(
-                    error_msg,
-                    response.status_code,
-                    error_data,
-                )
-            elif response.status_code == 429:
-                error_data = response.json() if response.content else {}
-                detail = error_data.get("detail", "Rate limit exceeded")
-                raise TangoRateLimitError(detail, response.status_code, error_data)
-            elif not response.is_success:
-                raise TangoAPIError(
-                    f"API request failed with status {response.status_code}", response.status_code
-                )
+            self._raise_for_status(response)
 
             return response.json() if response.content else {}
 
         except httpx.HTTPError as e:
             raise TangoAPIError(f"Request failed: {str(e)}") from e
 
+    def _raise_for_status(self, response: httpx.Response) -> None:
+        """Raise the SDK exception matching a non-success response; return quietly on success."""
+        if response.status_code == 401:
+            raise TangoAuthError("Invalid API key or authentication required", response.status_code)
+        elif response.status_code == 404:
+            raise TangoNotFoundError("Resource not found", response.status_code)
+        elif response.status_code == 400:
+            error_data = response.json() if response.content else {}
+            error_msg = "Invalid request parameters"
+            if error_data:
+                # Try to extract a more specific error message
+                if isinstance(error_data, dict):
+                    detail = (
+                        error_data.get("detail")
+                        or error_data.get("message")
+                        or error_data.get("error")
+                    )
+                    if detail:
+                        error_msg = f"Invalid request parameters: {detail}"
+                    issues = error_data.get("issues")
+                    if isinstance(issues, list):
+                        rejected = [
+                            f"{issue['path']} ({issue['reason']})"
+                            if issue.get("reason")
+                            else str(issue["path"])
+                            for issue in issues
+                            if isinstance(issue, dict) and issue.get("path")
+                        ]
+                        if rejected:
+                            error_msg = f"{error_msg}: {', '.join(rejected)}"
+            raise TangoValidationError(
+                error_msg,
+                response.status_code,
+                error_data,
+            )
+        elif response.status_code == 429:
+            error_data = response.json() if response.content else {}
+            detail = error_data.get("detail", "Rate limit exceeded")
+            raise TangoRateLimitError(detail, response.status_code, error_data)
+        elif not response.is_success:
+            raise TangoAPIError(
+                f"API request failed with status {response.status_code}", response.status_code
+            )
+
     def _get(self, endpoint: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
         """Make a GET request"""
         return self._request("GET", endpoint, params=params)
@@ -1601,18 +1607,18 @@ class TangoClient:
         cio_rating_max: int | None = None,
         performance_risk: bool | None = None,
         previous_uii: str | None = None,
+        agency: str | None = None,
     ) -> PaginatedResponse:
         """List federal IT investments from the IT Dashboard (`/api/itdashboard/`).
 
         Filters are tier-gated by the API:
 
-        - **Free**: ``search`` (full-text across UII, title, description, agency,
-          bureau) and ``previous_uii`` — following a retired identifier forward to
-          whatever superseded it is recovery, not analysis, so it is ungated
+        - **Free**: ``search`` (full-text across UII, title, description, agency, bureau), ``agency_name`` (text), ``agency`` and ``previous_uii`` — following a retired identifier forward to whatever superseded it is recovery, not analysis, so it is ungated
         - **Pro**: ``agency_code``, ``type_of_investment``,
           ``updated_time_after`` / ``updated_time_before``
-        - **Business+**: ``agency_name`` (text), ``cio_rating``,
-          ``cio_rating_max``, ``performance_risk``
+        - **Business+**: ``cio_rating``, ``cio_rating_max``, ``performance_risk``
+
+        ``agency`` takes a Tango agency name, abbreviation, code or organization key, e.g. ``DOT``, and matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``.
 
         Hitting a gated filter on a lower tier returns a 403 with upgrade info.
 
@@ -1632,6 +1638,7 @@ class TangoClient:
                 params["flat_lists"] = "true"
         for k, val in (
             ("search", search),
+            ("agency", agency),
             ("agency_code", agency_code),
             ("agency_name", agency_name),
             ("type_of_investment", type_of_investment),
@@ -2818,6 +2825,358 @@ class TangoClient:
         data = self._get(f"/api/contract_appeals/{appeal_id}/", params)
         return self._parse_response_with_shape(data, shape, ContractAppeal, flat, flat_lists)
 
+    # ============================================================================
+    # Federal Register documents
+    # ============================================================================
+
+    def list_federal_register_documents(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        search: str | None = None,
+        document_number: str | None = None,
+        type: str | None = None,
+        agency: str | None = None,
+        fr_agency: str | None = None,
+        publication_date_after: str | None = None,
+        publication_date_before: str | None = None,
+        effective_on_after: str | None = None,
+        effective_on_before: str | None = None,
+        comments_close_on_after: str | None = None,
+        comments_close_on_before: str | None = None,
+        comments_open: bool | None = None,
+        cfr_title: str | None = None,
+        cfr_part: str | None = None,
+        significant: bool | None = None,
+        rin: str | None = None,
+        executive_order_number: str | None = None,
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List Federal Register documents.
+
+        Rules, proposed rules, notices and presidential documents published in the Federal Register since 1994.
+
+        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
+            search: Ranked full-text search over the title, abstract and action. Wrap in double quotes for a phrase
+            document_number: Exact FR document number, e.g. ``2016-31922``. OR several with ``|``. A number the Federal Register reused before 2016 matches every document that carries it
+            type: ``Notice``, ``Rule``, ``Proposed Rule``, ``Presidential Document``, ``Correction``, ``Sunshine Act Document`` or ``Uncategorized Document`` (case-insensitive). OR several with ``|``. Documents published before 2008 are mostly ``Uncategorized Document``
+            agency: A Tango agency name, abbreviation, code or organization key, e.g. ``EPA``. Matches a document when any agency it lists falls within that organization, so a department includes its sub-agencies. OR several with ``|``
+            fr_agency: The Federal Register's own agency slug, e.g. ``environmental-protection-agency``. OR several with ``|``
+            publication_date_after: Published on or after (YYYY-MM-DD)
+            publication_date_before: Published on or before (YYYY-MM-DD)
+            effective_on_after: Effective on or after (YYYY-MM-DD)
+            effective_on_before: Effective on or before (YYYY-MM-DD)
+            comments_close_on_after: Comment period closes on or after (YYYY-MM-DD)
+            comments_close_on_before: Comment period closes on or before (YYYY-MM-DD)
+            comments_open: ``True`` for documents whose comment period closes today or later, ``False`` for those already closed. Documents with no comment deadline match neither
+            cfr_title: A CFR title number, e.g. ``40``
+            cfr_part: A CFR part number, e.g. ``52``. Requires ``cfr_title``, and both must match the same CFR reference
+            significant: Significant under Executive Order 12866
+            rin: A Regulation Identifier Number, e.g. ``2060-AV16``. OR several with ``|``
+            executive_order_number: Exact executive order number
+            ordering: Sort field — ``publication_date`` (the default, as ``-publication_date``), ``effective_on``, ``comments_close_on``, ``document_number`` or ``rank``. ``rank`` requires a non-empty ``search``
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.FEDERAL_REGISTER_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("search", search),
+            ("document_number", document_number),
+            ("type", type),
+            ("agency", agency),
+            ("fr_agency", fr_agency),
+            ("publication_date_after", publication_date_after),
+            ("publication_date_before", publication_date_before),
+            ("effective_on_after", effective_on_after),
+            ("effective_on_before", effective_on_before),
+            ("comments_close_on_after", comments_close_on_after),
+            ("comments_close_on_before", comments_close_on_before),
+            ("comments_open", comments_open),
+            ("cfr_title", cfr_title),
+            ("cfr_part", cfr_part),
+            ("significant", significant),
+            ("rin", rin),
+            ("executive_order_number", executive_order_number),
+            ("ordering", ordering),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/federal_register/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, FederalRegisterDocument, 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_federal_register_document(
+        self,
+        document_uuid: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single Federal Register document by uuid.
+
+        The detail route takes the document's ``uuid``, not its ``document_number``, which is not unique on its own.
+        To look a document up by number, use ``list_federal_register_documents(document_number=...)``.
+
+        Args:
+            document_uuid: Document UUID
+            shape: Response shape string (defaults to the comprehensive shape). Name ``full_text`` here to get the document's plain text, which can run to several MB
+            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.FEDERAL_REGISTER_COMPREHENSIVE
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/federal_register/{document_uuid}/", params)
+        return self._parse_response_with_shape(
+            data, shape, FederalRegisterDocument, flat, flat_lists
+        )
+
+    # ============================================================================
+    # GSA eBuy requests
+    # ============================================================================
+
+    def list_ebuy_requests(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        search: str | None = None,
+        rfq_id: str | None = None,
+        reference_number: str | None = None,
+        request_type: str | None = None,
+        status: str | None = None,
+        sin: str | None = None,
+        schedule: str | None = None,
+        buyer_agency: str | None = None,
+        agency: str | None = None,
+        contract_number: str | None = None,
+        issue_date_after: str | None = None,
+        issue_date_before: str | None = None,
+        close_date_after: str | None = None,
+        close_date_before: str | None = None,
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List GSA eBuy requests (RFQs, RFPs and RFIs).
+
+        Requires the Pro tier or above; below it the API returns 403.
+        Results are scoped to your account: you see only requests posted under the GSA schedule contracts linked to it.
+        With no linked contract the page is empty rather than an error, so use ``get_ebuy_access()`` to tell "no access" from "no matches".
+
+        ``status`` is frozen at the last state the request was seen in.
+        Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row, and ``Open`` means "open the last time it was seen".
+        Read ``last_seen`` for staleness.
+
+        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
+            search: Full-text search over the title, description, reference number, request id and attachment text. Results rank by relevance unless ``ordering`` is given
+            rfq_id: Exact request id, e.g. ``RFQ1835158``. OR several with ``|``
+            reference_number: The buyer's own solicitation number; dashes are ignored
+            request_type: ``RFQ``, ``RFP`` or ``RFI``. OR several with ``|``
+            status: ``Open`` or ``Cancelled``, as last seen. OR several with ``|``
+            sin: Special Item Number, e.g. ``54151S``. OR several with ``|``
+            schedule: GSA schedule. OR several with ``|``
+            buyer_agency: The buyer agency as eBuy names it (free text). OR several with ``|``
+            agency: A Tango agency name, abbreviation, code or organization key, e.g. ``GSA``. Matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``. Requires Tango API 5.3.0
+            contract_number: Narrow to requests posted under one of your own linked contracts. A contract not linked to your account returns an empty page, not an error
+            issue_date_after: Issued on or after (YYYY-MM-DD)
+            issue_date_before: Issued on or before (YYYY-MM-DD)
+            close_date_after: Closes on or after (YYYY-MM-DD)
+            close_date_before: Closes on or before (YYYY-MM-DD)
+            ordering: Sort field — ``issue_date`` (the default, as ``-issue_date``), ``close_date``, ``last_seen`` or ``modified``. Prefix ``-`` for descending
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.EBUY_REQUESTS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("search", search),
+            ("rfq_id", rfq_id),
+            ("reference_number", reference_number),
+            ("request_type", request_type),
+            ("status", status),
+            ("sin", sin),
+            ("schedule", schedule),
+            ("buyer_agency", buyer_agency),
+            ("agency", agency),
+            ("contract_number", contract_number),
+            ("issue_date_after", issue_date_after),
+            ("issue_date_before", issue_date_before),
+            ("close_date_after", close_date_after),
+            ("close_date_before", close_date_before),
+            ("ordering", ordering),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/ebuy/requests/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, EbuyRequest, 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_ebuy_request(
+        self,
+        rfq_id: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single GSA eBuy request by its request id.
+
+        A request outside your account's scope raises ``TangoNotFoundError``, the same as an id that does not exist.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            shape: Response shape string (defaults to the comprehensive shape: every field plus the ``organization`` and ``attachments`` expands)
+            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.EBUY_REQUESTS_COMPREHENSIVE
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/ebuy/requests/{quote(rfq_id, safe='')}/", params)
+        return self._parse_response_with_shape(data, shape, EbuyRequest, flat, flat_lists)
+
+    def get_ebuy_attachment_url(self, rfq_id: str, doc_seq_num: int) -> str:
+        """
+        Get a short-lived download URL for one attachment on a GSA eBuy request.
+
+        The API answers with a redirect to a signed URL that expires after about five minutes; this returns that URL without downloading the document.
+        Fetch it promptly, and call this again rather than storing it.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            doc_seq_num: The attachment's ``doc_seq_num`` from ``get_ebuy_request()``
+
+        Raises:
+            TangoAttachmentLinkError: The entry is an external link (``is_link``), not a stored document. The link is on ``.url`` and in the message. Subclasses ``TangoValidationError``.
+            TangoNotFoundError: The request is unknown or outside your scope, the attachment does not exist, or its document has not been captured yet.
+        """
+        endpoint = (
+            f"/api/ebuy/requests/{quote(rfq_id, safe='')}/attachments/{int(doc_seq_num)}/download/"
+        )
+        url = urljoin(f"{self.base_url}/", endpoint.lstrip("/"))
+
+        try:
+            response = self.client.request(method="GET", url=url, follow_redirects=False)
+        except httpx.HTTPError as e:
+            raise TangoAPIError(f"Request failed: {str(e)}") from e
+        self._last_response_headers = response.headers
+        self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
+
+        location = response.headers.get("Location")
+        if response.is_redirect and location:
+            return str(location)
+
+        if response.status_code in (400, 404):
+            try:
+                error_data = response.json() if response.content else {}
+            except ValueError:
+                error_data = {}
+            if not isinstance(error_data, dict):
+                error_data = {}
+            if response.status_code == 400 and error_data.get("url"):
+                raise TangoAttachmentLinkError(
+                    f"Attachment {doc_seq_num} on {rfq_id} is an external link, not a stored document: {error_data['url']}",
+                    response.status_code,
+                    error_data,
+                )
+            if response.status_code == 404:
+                raise TangoNotFoundError(
+                    error_data.get("detail") or "Resource not found",
+                    response.status_code,
+                    error_data,
+                )
+
+        self._raise_for_status(response)
+        raise TangoAPIError(
+            f"Expected a redirect to the attachment, got status {response.status_code}",
+            response.status_code,
+        )
+
+    def get_ebuy_access(self) -> EbuyAccess:
+        """
+        Check whether your account can read GSA eBuy requests.
+
+        ``list_ebuy_requests()`` returns an empty page, not an error, when no contract is linked; this tells the two apart.
+        ``reason`` is ``"tier_required"`` below the Pro tier (it wins when both apply), ``"no_contract_grant"`` when no contract is linked, and ``None`` when ``enabled`` is true.
+        ``contracts`` lists your own linked contracts, sorted.
+        """
+        data = self._get("/api/ebuy/access/")
+        return EbuyAccess(
+            enabled=bool(data.get("enabled")),
+            reason=data.get("reason"),
+            contracts=list(data.get("contracts") or []),
+        )
+
     # ============================================================================
     # DLA DIBBS (RFQs, RFPs, awards)
     # ============================================================================
@@ -3242,6 +3601,7 @@ class TangoClient:
         update_date_before: str | None = None,
         search: str | None = None,
         ordering: str | None = None,
+        agency: str | None = None,
     ) -> PaginatedResponse:
         """
         List SAM.gov exclusion (debarment) records.
@@ -3261,6 +3621,7 @@ class TangoClient:
             classification_type: Filter by classification (Firm, Individual, Vessel, ...)
             exclusion_type: Filter by exclusion type
             exclusion_program: Filter by exclusion program
+            agency: Excluding agency as a Tango organization. A Tango agency name, abbreviation, code or organization key, e.g. ``EPA``. Matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``
             excluding_agency_code: Filter by excluding agency code
             excluding_agency_name: Filter by excluding agency name
             active: True returns only records currently in effect.
@@ -3296,6 +3657,7 @@ class TangoClient:
             ("classification_type", classification_type),
             ("exclusion_type", exclusion_type),
             ("exclusion_program", exclusion_program),
+            ("agency", agency),
             ("excluding_agency_code", excluding_agency_code),
             ("excluding_agency_name", excluding_agency_name),
             ("active", active),
@@ -4153,6 +4515,7 @@ class TangoClient:
         actual_vs_requested_contract_capped_lte: float | None = None,
         search: str | None = None,
         ordering: str | None = None,
+        agency: str | None = None,
     ) -> PaginatedResponse:
         """List budget accounts (`/api/budget/accounts/`).
 
@@ -4170,6 +4533,7 @@ class TangoClient:
             fiscal_year: Fiscal year (exact).
             fiscal_year_gte: Fiscal year >=.
             fiscal_year_lte: Fiscal year <=.
+            agency: A Tango agency name, abbreviation, code or organization key, e.g. ``EPA``. Matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``.
             agency_code: Agency code (exact).
             bureau_name: Bureau name (exact).
             account_title: Account title (icontains).
@@ -4234,6 +4598,7 @@ class TangoClient:
             ("fiscal_year", fiscal_year),
             ("fiscal_year__gte", fiscal_year_gte),
             ("fiscal_year__lte", fiscal_year_lte),
+            ("agency", agency),
             ("agency_code", agency_code),
             ("bureau_name", bureau_name),
             ("account_title__icontains", account_title),
@@ -4870,8 +5235,8 @@ class TangoClient:
             name: Human-readable name for this alert.
             query_type: One of ``opportunity``, ``contract``, ``idv``, ``ota``,
                 ``otidv``, ``entity``, ``grant``, ``forecast``, ``exclusion``,
-                ``dibbs_rfq``, ``dibbs_rfp``, ``sled_opportunity`` or
-                ``contract_appeal``. :meth:`list_webhook_event_types` is the
+                ``dibbs_rfq``, ``dibbs_rfp``, ``sled_opportunity``,
+                ``contract_appeal``, ``federal_register`` or ``ebuy_request``. :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"}``).

tango/exceptions.py

@@ -53,6 +53,16 @@ class TangoValidationError(TangoAPIError):
         return val if isinstance(val, dict) else None
 
 
+class TangoAttachmentLinkError(TangoValidationError):
+    """The requested attachment is an external link, not a stored document, so there is nothing to download."""
+
+    @property
+    def url(self) -> str | None:
+        """The external link the entry points at."""
+        val = self.response_data.get("url")
+        return val if isinstance(val, str) else None
+
+
 class TangoRateLimitError(TangoAPIError):
     """Rate limit exceeded error"""
 

tango/models.py

@@ -1213,6 +1213,156 @@ class ContractAppeal:
     decision_text: str | None = None
 
 
+class FederalRegisterDocument:
+    """Schema definition for FederalRegisterDocument (not used for instances).
+
+    Federal Register documents at ``/api/federal_register/``: rules, proposed rules, notices and presidential documents published since 1994.
+    Shape-on-demand, so every field is optional.
+
+    A document is identified by ``uuid``.
+    ``document_number`` alone is not unique: the Federal Register reused some numbers before 2016, so ``document_number=`` can match more than one document.
+
+    ``agencies``, ``cfr_references``, ``dockets`` and ``topics`` are the Federal Register's own structures, served as published.
+    ``full_text`` can run to several MB, so it is available on the detail endpoint only and only when named in ``shape``.
+    """
+
+    uuid: str | None = None
+    document_number: str | None = None
+    publication_date: date | None = None
+    citation: str | None = None
+    title: str | None = None
+    type: str | None = None
+    subtype: str | None = None
+    abstract: str | None = None
+    action: str | None = None
+    dates: str | None = None
+    comments_close_on: date | None = None
+    effective_on: date | None = None
+    signing_date: date | None = None
+    start_page: int | None = None
+    end_page: int | None = None
+    page_length: int | None = None
+    volume: int | None = None
+    significant: bool | None = None
+    toc_doc: str | None = None
+    toc_subject: str | None = None
+    correction_of: str | None = None
+    corrections: list[str] | None = None
+    disposition_notes: str | None = None
+    executive_order_notes: str | None = None
+    executive_order_number: str | None = None
+    presidential_document_number: str | None = None
+    proclamation_number: str | None = None
+    not_received_for_publication: str | None = None
+    comment_url: str | None = None
+    regulations_dot_gov_url: str | None = None
+    html_url: str | None = None
+    body_html_url: str | None = None
+    pdf_url: str | None = None
+    public_inspection_pdf_url: str | None = None
+    raw_text_url: str | None = None
+    agencies: list[dict[str, Any]] | None = None
+    cfr_references: list[dict[str, Any]] | None = None
+    dockets: list[dict[str, Any]] | None = None
+    docket_ids: list[str] | None = None
+    topics: list[str] | None = None
+    regulation_id_numbers: list[str] | None = None
+    regulation_id_number_info: dict[str, Any] | None = None
+    regulations_dot_gov_info: dict[str, Any] | None = None
+    full_text: str | None = None
+
+
+class EbuyAttachment:
+    """Schema definition for one entry in an eBuy request's ``attachments`` (not used for instances).
+
+    ``is_link=True`` means the entry is an outbound URL in ``doc_path`` with no stored document behind it, so ``get_ebuy_attachment_url()`` raises ``TangoAttachmentLinkError`` for it.
+    """
+
+    doc_seq_num: int | None = None
+    doc_name: str | None = None
+    doc_type: int | None = None
+    doc_path: str | None = None
+    is_link: bool | None = None
+    doc_session_date: datetime | None = None
+
+
+class EbuyRequest:
+    """Schema definition for EbuyRequest (not used for instances).
+
+    GSA eBuy requests (RFQs, RFPs, RFIs) at ``/api/ebuy/requests/``, keyed by ``rfq_id``.
+    Shape-on-demand, so every field is optional.
+
+    The resource is scoped to your account: you see only requests posted under the GSA schedule contracts linked to it.
+
+    ``status`` is frozen at the last state the request was seen in.
+    Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row, and ``Open`` means "open the last time it was seen".
+    Read ``last_seen`` for staleness.
+
+    ``buyer_agency_code`` and some other buyer and contact fields are sparse on older requests.
+    The contract number a request was posted under is never returned.
+    """
+
+    rfq_id: str | None = None
+    request_type: str | None = None
+    title: str | None = None
+    description: str | None = None
+    schedule: str | None = None
+    sin: str | None = None
+    status: str | None = None
+    buyer_name: str | None = None
+    buyer_agency: str | None = None
+    buyer_agency_code: str | None = None
+    buyer_email: str | None = None
+    buyer_user_id: str | None = None
+    reference_number: str | None = None
+    award_method: str | None = None
+    contract_type: str | None = None
+    commercial_type: str | None = None
+    follow_on: bool | None = None
+    source_sought: bool | None = None
+    issue_date: datetime | None = None
+    close_date: datetime | None = None
+    cancel_date: datetime | None = None
+    last_mod_date: datetime | None = None
+    pop_start_date: datetime | None = None
+    pop_end_date: datetime | None = None
+    oco_name: str | None = None
+    oco_title: str | None = None
+    oco_agency: str | None = None
+    oco_phone: str | None = None
+    oco_aac: str | None = None
+    ocs_name: str | None = None
+    ocs_title: str | None = None
+    ocs_agency: str | None = None
+    ocs_phone: str | None = None
+    ocs_aac: str | None = None
+    amendment_count: int | None = None
+    mod_version: int | None = None
+    qa_document_count: int | None = None
+    attachment_count: int | None = None
+    link_count: int | None = None
+    amendments: list[dict[str, Any]] | None = None
+    line_items: list[dict[str, Any]] | None = None
+    addresses: list[dict[str, Any]] | None = None
+    detail_fetched: bool | None = None
+    first_seen: datetime | None = None
+    last_seen: datetime | None = None
+    organization: dict[str, Any] | None = None
+    attachments: list[EbuyAttachment] | None = None
+
+
+@dataclass
+class EbuyAccess:
+    """Result of ``GET /api/ebuy/access/``: whether your account can read eBuy requests.
+
+    ``list_ebuy_requests()`` returns an empty page, not an error, when no contract is linked, so this is how to tell "no access" from "no matches".
+    """
+
+    enabled: bool
+    reason: Literal["tier_required", "no_contract_grant"] | None
+    contracts: list[str]
+
+
 @dataclass
 class PaginatedResponse[T]:
     """Paginated API response
@@ -1394,6 +1544,44 @@ class ShapeConfig:
         "listing_year,first_listed_at,listed,text_status,text_char_count"
     )
 
+    # Default for list_federal_register_documents(). Mirrors the API's own list default.
+    FEDERAL_REGISTER_MINIMAL: Final = (
+        "uuid,document_number,publication_date,type,subtype,title,abstract,action,"
+        "agencies,cfr_references,citation,significant,comments_close_on,effective_on,"
+        "html_url,pdf_url"
+    )
+
+    # Default for get_federal_register_document(). Mirrors the API's own retrieve default.
+    # `full_text` is left out on purpose: it can run to several MB.
+    FEDERAL_REGISTER_COMPREHENSIVE: Final = (
+        "uuid,document_number,publication_date,type,subtype,title,abstract,action,"
+        "agencies,cfr_references,citation,significant,comments_close_on,effective_on,"
+        "html_url,pdf_url,dates,signing_date,start_page,end_page,volume,docket_ids,"
+        "dockets,regulation_id_numbers,topics,correction_of,corrections,"
+        "executive_order_number,presidential_document_number,proclamation_number,"
+        "comment_url,regulations_dot_gov_url,raw_text_url,body_html_url"
+    )
+
+    # Default for list_ebuy_requests(). Mirrors the API's own list default.
+    EBUY_REQUESTS_MINIMAL: Final = (
+        "rfq_id,request_type,title,schedule,sin,status,buyer_name,buyer_agency,"
+        "buyer_agency_code,reference_number,issue_date,close_date,attachment_count,"
+        "link_count,last_seen"
+    )
+
+    # Default for get_ebuy_request(). Mirrors the API's own retrieve default; the attachment fields are named rather than `attachments(*)` so their dates parse.
+    EBUY_REQUESTS_COMPREHENSIVE: Final = (
+        "rfq_id,request_type,title,description,schedule,sin,status,buyer_name,"
+        "buyer_agency,buyer_agency_code,buyer_email,buyer_user_id,reference_number,"
+        "award_method,contract_type,commercial_type,follow_on,source_sought,issue_date,"
+        "close_date,cancel_date,last_mod_date,pop_start_date,pop_end_date,oco_name,"
+        "oco_title,oco_agency,oco_phone,oco_aac,ocs_name,ocs_title,ocs_agency,ocs_phone,"
+        "ocs_aac,amendment_count,mod_version,qa_document_count,attachment_count,"
+        "link_count,amendments,line_items,addresses,detail_fetched,first_seen,last_seen,"
+        "organization(*),"
+        "attachments(doc_seq_num,doc_name,doc_type,doc_path,is_link,doc_session_date)"
+    )
+
     # Default for list_dibbs_rfqs()
     DIBBS_RFQS_MINIMAL: Final = (
         "uuid,solicitation,nsn,part_number,nomenclature,quantity,issue_date,return_by_date,is_open"

tango/shapes/explicit_schemas.py

@@ -800,6 +800,174 @@ CONTRACT_APPEAL_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+FEDERAL_REGISTER_DOCUMENT_SCHEMA: dict[str, FieldSchema] = {
+    "uuid": FieldSchema(name="uuid", type=str, is_optional=True, is_list=False),
+    "document_number": FieldSchema(
+        name="document_number", type=str, is_optional=True, is_list=False
+    ),
+    "publication_date": FieldSchema(
+        name="publication_date", type=date, is_optional=True, is_list=False
+    ),
+    "citation": FieldSchema(name="citation", type=str, is_optional=True, is_list=False),
+    "title": FieldSchema(name="title", type=str, is_optional=True, is_list=False),
+    "type": FieldSchema(name="type", type=str, is_optional=True, is_list=False),
+    "subtype": FieldSchema(name="subtype", type=str, is_optional=True, is_list=False),
+    "abstract": FieldSchema(name="abstract", type=str, is_optional=True, is_list=False),
+    "action": FieldSchema(name="action", type=str, is_optional=True, is_list=False),
+    "dates": FieldSchema(name="dates", type=str, is_optional=True, is_list=False),
+    "comments_close_on": FieldSchema(
+        name="comments_close_on", type=date, is_optional=True, is_list=False
+    ),
+    "effective_on": FieldSchema(name="effective_on", type=date, is_optional=True, is_list=False),
+    "signing_date": FieldSchema(name="signing_date", type=date, is_optional=True, is_list=False),
+    "start_page": FieldSchema(name="start_page", type=int, is_optional=True, is_list=False),
+    "end_page": FieldSchema(name="end_page", type=int, is_optional=True, is_list=False),
+    "page_length": FieldSchema(name="page_length", type=int, is_optional=True, is_list=False),
+    "volume": FieldSchema(name="volume", type=int, is_optional=True, is_list=False),
+    "significant": FieldSchema(name="significant", type=bool, is_optional=True, is_list=False),
+    "toc_doc": FieldSchema(name="toc_doc", type=str, is_optional=True, is_list=False),
+    "toc_subject": FieldSchema(name="toc_subject", type=str, is_optional=True, is_list=False),
+    "correction_of": FieldSchema(name="correction_of", type=str, is_optional=True, is_list=False),
+    "corrections": FieldSchema(name="corrections", type=str, is_optional=True, is_list=True),
+    "disposition_notes": FieldSchema(
+        name="disposition_notes", type=str, is_optional=True, is_list=False
+    ),
+    "executive_order_notes": FieldSchema(
+        name="executive_order_notes", type=str, is_optional=True, is_list=False
+    ),
+    "executive_order_number": FieldSchema(
+        name="executive_order_number", type=str, is_optional=True, is_list=False
+    ),
+    "presidential_document_number": FieldSchema(
+        name="presidential_document_number", type=str, is_optional=True, is_list=False
+    ),
+    "proclamation_number": FieldSchema(
+        name="proclamation_number", type=str, is_optional=True, is_list=False
+    ),
+    "not_received_for_publication": FieldSchema(
+        name="not_received_for_publication", type=str, is_optional=True, is_list=False
+    ),
+    "comment_url": FieldSchema(name="comment_url", type=str, is_optional=True, is_list=False),
+    "regulations_dot_gov_url": FieldSchema(
+        name="regulations_dot_gov_url", type=str, is_optional=True, is_list=False
+    ),
+    "html_url": FieldSchema(name="html_url", type=str, is_optional=True, is_list=False),
+    "body_html_url": FieldSchema(name="body_html_url", type=str, is_optional=True, is_list=False),
+    "pdf_url": FieldSchema(name="pdf_url", type=str, is_optional=True, is_list=False),
+    "public_inspection_pdf_url": FieldSchema(
+        name="public_inspection_pdf_url", type=str, is_optional=True, is_list=False
+    ),
+    "raw_text_url": FieldSchema(name="raw_text_url", type=str, is_optional=True, is_list=False),
+    "agencies": FieldSchema(name="agencies", type=dict, is_optional=True, is_list=True),
+    "cfr_references": FieldSchema(name="cfr_references", type=dict, is_optional=True, is_list=True),
+    "dockets": FieldSchema(name="dockets", type=dict, is_optional=True, is_list=True),
+    "docket_ids": FieldSchema(name="docket_ids", type=str, is_optional=True, is_list=True),
+    "topics": FieldSchema(name="topics", type=str, is_optional=True, is_list=True),
+    "regulation_id_numbers": FieldSchema(
+        name="regulation_id_numbers", type=str, is_optional=True, is_list=True
+    ),
+    "regulation_id_number_info": FieldSchema(
+        name="regulation_id_number_info", type=dict, is_optional=True, is_list=False
+    ),
+    "regulations_dot_gov_info": FieldSchema(
+        name="regulations_dot_gov_info", type=dict, is_optional=True, is_list=False
+    ),
+    # Detail endpoint only, and only when named in the shape.
+    "full_text": FieldSchema(name="full_text", type=str, is_optional=True, is_list=False),
+}
+
+
+EBUY_ATTACHMENT_SCHEMA: dict[str, FieldSchema] = {
+    "doc_seq_num": FieldSchema(name="doc_seq_num", type=int, is_optional=True, is_list=False),
+    "doc_name": FieldSchema(name="doc_name", type=str, is_optional=True, is_list=False),
+    "doc_type": FieldSchema(name="doc_type", type=int, is_optional=True, is_list=False),
+    "doc_path": FieldSchema(name="doc_path", type=str, is_optional=True, is_list=False),
+    "is_link": FieldSchema(name="is_link", type=bool, is_optional=True, is_list=False),
+    "doc_session_date": FieldSchema(
+        name="doc_session_date", type=datetime, is_optional=True, is_list=False
+    ),
+}
+
+
+EBUY_REQUEST_SCHEMA: dict[str, FieldSchema] = {
+    "rfq_id": FieldSchema(name="rfq_id", type=str, is_optional=True, is_list=False),
+    "request_type": FieldSchema(name="request_type", type=str, is_optional=True, is_list=False),
+    "title": FieldSchema(name="title", type=str, is_optional=True, is_list=False),
+    "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
+    "schedule": FieldSchema(name="schedule", type=str, is_optional=True, is_list=False),
+    "sin": FieldSchema(name="sin", type=str, is_optional=True, is_list=False),
+    "status": FieldSchema(name="status", type=str, is_optional=True, is_list=False),
+    "buyer_name": FieldSchema(name="buyer_name", type=str, is_optional=True, is_list=False),
+    "buyer_agency": FieldSchema(name="buyer_agency", type=str, is_optional=True, is_list=False),
+    "buyer_agency_code": FieldSchema(
+        name="buyer_agency_code", type=str, is_optional=True, is_list=False
+    ),
+    "buyer_email": FieldSchema(name="buyer_email", type=str, is_optional=True, is_list=False),
+    "buyer_user_id": FieldSchema(name="buyer_user_id", type=str, is_optional=True, is_list=False),
+    "reference_number": FieldSchema(
+        name="reference_number", type=str, is_optional=True, is_list=False
+    ),
+    "award_method": FieldSchema(name="award_method", type=str, is_optional=True, is_list=False),
+    "contract_type": FieldSchema(name="contract_type", type=str, is_optional=True, is_list=False),
+    "commercial_type": FieldSchema(
+        name="commercial_type", type=str, is_optional=True, is_list=False
+    ),
+    "follow_on": FieldSchema(name="follow_on", type=bool, is_optional=True, is_list=False),
+    "source_sought": FieldSchema(name="source_sought", type=bool, is_optional=True, is_list=False),
+    "issue_date": FieldSchema(name="issue_date", type=datetime, is_optional=True, is_list=False),
+    "close_date": FieldSchema(name="close_date", type=datetime, is_optional=True, is_list=False),
+    "cancel_date": FieldSchema(name="cancel_date", type=datetime, is_optional=True, is_list=False),
+    "last_mod_date": FieldSchema(
+        name="last_mod_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "pop_start_date": FieldSchema(
+        name="pop_start_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "pop_end_date": FieldSchema(
+        name="pop_end_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "oco_name": FieldSchema(name="oco_name", type=str, is_optional=True, is_list=False),
+    "oco_title": FieldSchema(name="oco_title", type=str, is_optional=True, is_list=False),
+    "oco_agency": FieldSchema(name="oco_agency", type=str, is_optional=True, is_list=False),
+    "oco_phone": FieldSchema(name="oco_phone", type=str, is_optional=True, is_list=False),
+    "oco_aac": FieldSchema(name="oco_aac", type=str, is_optional=True, is_list=False),
+    "ocs_name": FieldSchema(name="ocs_name", type=str, is_optional=True, is_list=False),
+    "ocs_title": FieldSchema(name="ocs_title", type=str, is_optional=True, is_list=False),
+    "ocs_agency": FieldSchema(name="ocs_agency", type=str, is_optional=True, is_list=False),
+    "ocs_phone": FieldSchema(name="ocs_phone", type=str, is_optional=True, is_list=False),
+    "ocs_aac": FieldSchema(name="ocs_aac", type=str, is_optional=True, is_list=False),
+    "amendment_count": FieldSchema(
+        name="amendment_count", type=int, is_optional=True, is_list=False
+    ),
+    "mod_version": FieldSchema(name="mod_version", type=int, is_optional=True, is_list=False),
+    "qa_document_count": FieldSchema(
+        name="qa_document_count", type=int, is_optional=True, is_list=False
+    ),
+    "attachment_count": FieldSchema(
+        name="attachment_count", type=int, is_optional=True, is_list=False
+    ),
+    "link_count": FieldSchema(name="link_count", type=int, is_optional=True, is_list=False),
+    "amendments": FieldSchema(name="amendments", type=dict, is_optional=True, is_list=True),
+    "line_items": FieldSchema(name="line_items", type=dict, is_optional=True, is_list=True),
+    "addresses": FieldSchema(name="addresses", type=dict, is_optional=True, is_list=True),
+    "detail_fetched": FieldSchema(
+        name="detail_fetched", type=bool, is_optional=True, is_list=False
+    ),
+    "first_seen": FieldSchema(name="first_seen", type=datetime, is_optional=True, is_list=False),
+    "last_seen": FieldSchema(name="last_seen", type=datetime, is_optional=True, is_list=False),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
+    "attachments": FieldSchema(
+        name="attachments", type=dict, is_optional=True, is_list=True, nested_model="EbuyAttachment"
+    ),
+}
+
+
 AGENCY_SCHEMA: dict[str, FieldSchema] = {
     "abbreviation": FieldSchema(name="abbreviation", type=str, is_optional=True, is_list=False),
     "code": FieldSchema(name="code", type=str, is_optional=False, is_list=False),
@@ -1545,6 +1713,9 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "Protest": PROTEST_SCHEMA,
     "ProtestDocket": PROTEST_DOCKET_SCHEMA,
     "ContractAppeal": CONTRACT_APPEAL_SCHEMA,
+    "FederalRegisterDocument": FEDERAL_REGISTER_DOCUMENT_SCHEMA,
+    "EbuyRequest": EBUY_REQUEST_SCHEMA,
+    "EbuyAttachment": EBUY_ATTACHMENT_SCHEMA,
     "Agency": AGENCY_SCHEMA,
     "Grant": GRANT_SCHEMA,
     # Vehicles (Awards)

tango/shapes/generated_overlay.py

@@ -81,17 +81,6 @@ ARCHIVE_SCHEMA: dict[str, FieldSchema] = {
 }
 
 ATTACHMENTS_SCHEMA: dict[str, FieldSchema] = {
-    "doc_name": FieldSchema(name="doc_name", type=str, is_optional=True, is_list=False),
-    "doc_path": FieldSchema(name="doc_path", type=str, is_optional=True, is_list=False),
-    "doc_seq_num": FieldSchema(name="doc_seq_num", type=str, is_optional=True, is_list=False),
-    "doc_session_date": FieldSchema(
-        name="doc_session_date", type=date, is_optional=True, is_list=False
-    ),
-    "doc_type": FieldSchema(name="doc_type", type=str, is_optional=True, is_list=False),
-    "is_link": FieldSchema(name="is_link", type=bool, is_optional=True, is_list=False),
-}
-
-ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -105,7 +94,7 @@ ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -119,7 +108,7 @@ ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
     "char_count": FieldSchema(name="char_count", type=int, is_optional=True, is_list=False),
     "checksum": FieldSchema(name="checksum", type=str, is_optional=True, is_list=False),
     "download_status": FieldSchema(
@@ -144,7 +133,7 @@ ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
     "word_count": FieldSchema(name="word_count", type=int, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "file_size": FieldSchema(name="file_size", type=str, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
@@ -155,7 +144,7 @@ ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS6_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -1119,7 +1108,6 @@ GENERATED_NESTED: dict[str, dict[str, FieldSchema]] = {
     "Attachments3": ATTACHMENTS3_SCHEMA,
     "Attachments4": ATTACHMENTS4_SCHEMA,
     "Attachments5": ATTACHMENTS5_SCHEMA,
-    "Attachments6": ATTACHMENTS6_SCHEMA,
     "Awardee": AWARDEE_SCHEMA,
     "AwardingOffice": AWARDING_OFFICE_SCHEMA,
     "AwardingOffice2": AWARDING_OFFICE2_SCHEMA,
@@ -1382,6 +1370,16 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
         "on_off_budget": FieldSchema(
             name="on_off_budget", type=str, is_optional=True, is_list=False
         ),
+        "organization": FieldSchema(
+            name="organization",
+            type=dict,
+            is_optional=True,
+            is_list=False,
+            nested_model="AwardingOffice",
+        ),
+        "organization_id": FieldSchema(
+            name="organization_id", type=str, is_optional=True, is_list=False
+        ),
         "outlayed_to_obligated_pct": FieldSchema(
             name="outlayed_to_obligated_pct", type=str, is_optional=True, is_list=False
         ),
@@ -1911,6 +1909,16 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             name="more_locations", type=str, is_optional=True, is_list=False
         ),
         "npi": FieldSchema(name="npi", type=str, is_optional=True, is_list=False),
+        "organization": FieldSchema(
+            name="organization",
+            type=dict,
+            is_optional=True,
+            is_list=False,
+            nested_model="AwardingOffice",
+        ),
+        "organization_id": FieldSchema(
+            name="organization_id", type=str, is_optional=True, is_list=False
+        ),
         "prefix": FieldSchema(name="prefix", type=str, is_optional=True, is_list=False),
         "primary_address": FieldSchema(
             name="primary_address", type=str, is_optional=True, is_list=False
@@ -2218,7 +2226,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=True,
-            nested_model="Attachments2",
+            nested_model="Attachments",
         ),
         "meta": FieldSchema(
             name="meta", type=dict, is_optional=True, is_list=False, nested_model="Meta"
@@ -2466,7 +2474,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=False,
-            nested_model="Attachments6",
+            nested_model="Attachments5",
         ),
         "department": FieldSchema(
             name="department",
@@ -2683,6 +2691,13 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             name="documents", type=dict, is_optional=True, is_list=True, nested_model="Documents"
         ),
         "end_date": FieldSchema(name="end_date", type=date, is_optional=True, is_list=False),
+        "organization": FieldSchema(
+            name="organization",
+            type=dict,
+            is_optional=True,
+            is_list=False,
+            nested_model="AwardingOffice",
+        ),
         "out_of_cycle": FieldSchema(
             name="out_of_cycle", type=bool, is_optional=True, is_list=False
         ),
@@ -2736,6 +2751,13 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             is_list=False,
             nested_model="Opportunity2",
         ),
+        "organization": FieldSchema(
+            name="organization",
+            type=dict,
+            is_optional=True,
+            is_list=False,
+            nested_model="AwardingOffice",
+        ),
         "release_date": FieldSchema(
             name="release_date", type=date, is_optional=True, is_list=False
         ),
@@ -2839,7 +2861,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=True,
-            nested_model="Attachments4",
+            nested_model="Attachments3",
         ),
         "bid_opening_date": FieldSchema(
             name="bid_opening_date", type=datetime, is_optional=True, is_list=False

{tango_python-1.7.0.dist-info → tango_python-1.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.7.0
+Version: 1.9.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
@@ -308,6 +308,15 @@ protests = client.list_protests(source_system="gao", outcome="Sustained", limit=
 protest = client.get_protest("CASE_UUID")
 ```
 
+### GSA eBuy
+
+```python
+access = client.get_ebuy_access()  # scoped to the schedule contracts linked to your account
+requests = client.list_ebuy_requests(status="Open", sin="54151S", limit=25)
+request = client.get_ebuy_request("RFQ1835158")
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)  # short-lived signed URL
+```
+
 ### GSA eLibrary Contracts
 
 ```python

{tango_python-1.7.0.dist-info → tango_python-1.9.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
-tango/__init__.py,sha256=P7q3qdG_74A9OKteDHRNyH1pD_VuPOoBFGSFZECbVA0,2300
-tango/client.py,sha256=R69lCC6XTo42lVbuWXqEJNyO0-tro0IthgwyWiuJs6Y,220172
-tango/exceptions.py,sha256=B1t27BBxHcPglAfJQyan5khNEYNAyF6Wkp2EmPMdRxM,3858
-tango/models.py,sha256=X5ijWFnz05kgobqoPdtxRxWWW_hVfFZRtCGksbgQW-o,58377
+tango/__init__.py,sha256=jdqZItlsYrPAUN5SNr0jxMzKta8MVebhkafeJkatzyI,2534
+tango/client.py,sha256=_QCR5rwYPHs1YHsuf9TCEJXQoNIcHshF5nRrArmuf7s,237760
+tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
+tango/models.py,sha256=Ujvt-cUxfFA2VZoAfRZs77WPcwUdyb-Hw-EWkoa7mrw,66613
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=WvkKaEkW01HgO56In-8vNlxZeoEkJJEYjZOUyrGItU4,73775
+tango/shapes/explicit_schemas.py,sha256=spYyMmWKOiMJygz9yViBQrjIxUPFfv7HpVkJcWy13x8,84021
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
-tango/shapes/generated_overlay.py,sha256=wv3Z4MjsU7xyk8EKzUNG1BgfAxgukGcsQ_5QkPPJyvA,137957
+tango/shapes/generated_overlay.py,sha256=X6VLGbO2sgh4X_u8hJmIqnB30Hct8XZDQfnSbIV7tBU,138368
 tango/shapes/generator.py,sha256=xzakpwTwqTMUr89I06hp54-FIYZziviWHk2Glscg-LM,22775
 tango/shapes/models.py,sha256=h3pIhOqrrdlN953Y6r0oney5HFbKPOD-frRndRWimJ0,3018
 tango/shapes/parser.py,sha256=AecNx5oT_hV_pf2AWZnsR8Y2aLmCtjfgS9-znA2Pesc,27429
@@ -16,8 +16,8 @@ tango/webhooks/cli.py,sha256=f_vQbJ2AeSQjKnQo7MxHFyUB2SAKcgHYmGQULS0isqQ,13858
 tango/webhooks/receiver.py,sha256=5yhsVhlLyoxmOCGvmbynWAIlDB2OaCPVf1H4GA1SxmU,9279
 tango/webhooks/signing.py,sha256=92Ee-0B6PR7ZkvY3Np3gzl88-mtfKkh-I7lxqCe2lGw,2374
 tango/webhooks/simulate.py,sha256=g2Osa0FYU5mJuon07T2aUCtmkUoTEzsY261tlp76fF0,3165
-tango_python-1.7.0.dist-info/METADATA,sha256=1Jf7m5SbI4g54SfWLy1LQxFVz-W2LA1uLbYA3MBkBlE,21779
-tango_python-1.7.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.7.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.7.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.7.0.dist-info/RECORD,,
+tango_python-1.9.0.dist-info/METADATA,sha256=FFL14hmyg_t__WWg6lSxVA3ydOSA8GwLoaIdysJsuog,22117
+tango_python-1.9.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+tango_python-1.9.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.9.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.9.0.dist-info/RECORD,,