permitstack 1.1.0__tar.gz → 1.1.2__tar.gz

{permitstack-1.1.0 → permitstack-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: permitstack
-Version: 1.1.0
+Version: 1.1.2
 Summary: Official Python SDK for the PermitStack building permit data API.
 Author: PermitStack
 License: Apache-2.0
@@ -25,7 +25,7 @@ Developer-friendly & type-safe Python SDK specifically catered to leverage *perm
 PermitStack: 
 ## PermitStack Building Permit API
 
-Access 39M+ building permits across 171 active U.S. jurisdictions (plus 19 historical archives), updated daily from official open data portals.
+Access 58M+ building permits across 552 active U.S. jurisdictions (plus 51 historical archives), updated daily from official open data portals.
 
 ### Getting started
 1. Sign up at [permit-stack.com](https://permit-stack.com/#pricing) for a free API key (100 req/day)
@@ -244,13 +244,18 @@ with Permitstack(
 
 * [search_permits](docs/sdks/permits/README.md#search_permits) - Search Permits
 * [export_permits](docs/sdks/permits/README.md#export_permits) - Export Permits
+* [list_permit_events](docs/sdks/permits/README.md#list_permit_events) - List Permit Events
 * [get_permit](docs/sdks/permits/README.md#get_permit) - Get Permit
 * [get_permits_by_address](docs/sdks/permits/README.md#get_permits_by_address) - Get Permits By Address
 * [get_coverage_stats](docs/sdks/permits/README.md#get_coverage_stats) - Get Coverage Stats
+* [list_plays](docs/sdks/permits/README.md#list_plays) - List Plays
+* [battery_retrofit_candidates](docs/sdks/permits/README.md#battery_retrofit_candidates) - Battery Retrofit Candidates
+* [orphan_recovery](docs/sdks/permits/README.md#orphan_recovery) - Orphan Recovery
 
 ### [PropertyHistory](docs/sdks/propertyhistory/README.md)
 
 * [get_property_history](docs/sdks/propertyhistory/README.md#get_property_history) - Get Property History
+* [get_property_by_parcel](docs/sdks/propertyhistory/README.md#get_property_by_parcel) - Get Property By Parcel
 
 ### [Webhooks](docs/sdks/webhooks/README.md)
 
@@ -367,7 +372,7 @@ with Permitstack(
 
 
 **Inherit from [`PermitstackError`](./src/permitstack/errors/permitstackerror.py)**:
-* [`HTTPValidationError`](./src/permitstack/errors/httpvalidationerror.py): Validation Error. Status code `422`. Applicable to 12 of 16 methods.*
+* [`HTTPValidationError`](./src/permitstack/errors/httpvalidationerror.py): Validation Error. Status code `422`. Applicable to 16 of 21 methods.*
 * [`ResponseValidationError`](./src/permitstack/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{permitstack-1.1.0 → permitstack-1.1.2}/README.md

@@ -13,7 +13,7 @@ Developer-friendly & type-safe Python SDK specifically catered to leverage *perm
 PermitStack: 
 ## PermitStack Building Permit API
 
-Access 39M+ building permits across 171 active U.S. jurisdictions (plus 19 historical archives), updated daily from official open data portals.
+Access 58M+ building permits across 552 active U.S. jurisdictions (plus 51 historical archives), updated daily from official open data portals.
 
 ### Getting started
 1. Sign up at [permit-stack.com](https://permit-stack.com/#pricing) for a free API key (100 req/day)
@@ -232,13 +232,18 @@ with Permitstack(
 
 * [search_permits](docs/sdks/permits/README.md#search_permits) - Search Permits
 * [export_permits](docs/sdks/permits/README.md#export_permits) - Export Permits
+* [list_permit_events](docs/sdks/permits/README.md#list_permit_events) - List Permit Events
 * [get_permit](docs/sdks/permits/README.md#get_permit) - Get Permit
 * [get_permits_by_address](docs/sdks/permits/README.md#get_permits_by_address) - Get Permits By Address
 * [get_coverage_stats](docs/sdks/permits/README.md#get_coverage_stats) - Get Coverage Stats
+* [list_plays](docs/sdks/permits/README.md#list_plays) - List Plays
+* [battery_retrofit_candidates](docs/sdks/permits/README.md#battery_retrofit_candidates) - Battery Retrofit Candidates
+* [orphan_recovery](docs/sdks/permits/README.md#orphan_recovery) - Orphan Recovery
 
 ### [PropertyHistory](docs/sdks/propertyhistory/README.md)
 
 * [get_property_history](docs/sdks/propertyhistory/README.md#get_property_history) - Get Property History
+* [get_property_by_parcel](docs/sdks/propertyhistory/README.md#get_property_by_parcel) - Get Property By Parcel
 
 ### [Webhooks](docs/sdks/webhooks/README.md)
 
@@ -355,7 +360,7 @@ with Permitstack(
 
 
 **Inherit from [`PermitstackError`](./src/permitstack/errors/permitstackerror.py)**:
-* [`HTTPValidationError`](./src/permitstack/errors/httpvalidationerror.py): Validation Error. Status code `422`. Applicable to 12 of 16 methods.*
+* [`HTTPValidationError`](./src/permitstack/errors/httpvalidationerror.py): Validation Error. Status code `422`. Applicable to 16 of 21 methods.*
 * [`ResponseValidationError`](./src/permitstack/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{permitstack-1.1.0 → permitstack-1.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "permitstack"
-version = "1.1.0"
+version = "1.1.2"
 description = "Official Python SDK for the PermitStack building permit data API."
 authors = [{ name = "PermitStack" },]
 readme = "README.md"

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "permitstack"
-__version__: str = "1.1.0"
+__version__: str = "1.1.1"
 __openapi_doc_version__: str = "1.0.0"
-__gen_version__: str = "2.893.0"
-__user_agent__: str = "speakeasy-sdk/python 1.1.0 2.893.0 1.0.0 permitstack"
+__gen_version__: str = "2.911.0"
+__user_agent__: str = "speakeasy-sdk/python 1.1.1 2.911.0 1.0.0 permitstack"
 
 try:
     if __package__ is not None:

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/contractors.py

@@ -20,6 +20,8 @@ class Contractors(BaseSDK):
         city: OptionalNullable[str] = UNSET,
         specialty: OptionalNullable[str] = UNSET,
         min_permits: OptionalNullable[int] = UNSET,
+        min_score: OptionalNullable[int] = UNSET,
+        sort: Optional[str] = "score",
         page: Optional[int] = 1,
         per_page: Optional[int] = 25,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -29,13 +31,15 @@ class Contractors(BaseSDK):
     ) -> models.ContractorSearchResponse:
         r"""Search Contractors
 
-        Search contractors by name, location, or specialty.
+        Search contractors by name, location, or specialty, ranked by activity score.
 
         :param name: Contractor name (partial match)
         :param state: 2-letter state code
         :param city: City name
         :param specialty: Specialty tag (e.g. solar, roofing, hvac)
         :param min_permits: Minimum total permits
+        :param min_score: Minimum contractor activity score (0-100)
+        :param sort: Sort order: 'score' (default), 'permits', or 'recent'
         :param page:
         :param per_page:
         :param retries: Override the default retry configuration for this method
@@ -59,6 +63,8 @@ class Contractors(BaseSDK):
             city=city,
             specialty=specialty,
             min_permits=min_permits,
+            min_score=min_score,
+            sort=sort,
             page=page,
             per_page=per_page,
         )
@@ -132,6 +138,8 @@ class Contractors(BaseSDK):
         city: OptionalNullable[str] = UNSET,
         specialty: OptionalNullable[str] = UNSET,
         min_permits: OptionalNullable[int] = UNSET,
+        min_score: OptionalNullable[int] = UNSET,
+        sort: Optional[str] = "score",
         page: Optional[int] = 1,
         per_page: Optional[int] = 25,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -141,13 +149,15 @@ class Contractors(BaseSDK):
     ) -> models.ContractorSearchResponse:
         r"""Search Contractors
 
-        Search contractors by name, location, or specialty.
+        Search contractors by name, location, or specialty, ranked by activity score.
 
         :param name: Contractor name (partial match)
         :param state: 2-letter state code
         :param city: City name
         :param specialty: Specialty tag (e.g. solar, roofing, hvac)
         :param min_permits: Minimum total permits
+        :param min_score: Minimum contractor activity score (0-100)
+        :param sort: Sort order: 'score' (default), 'permits', or 'recent'
         :param page:
         :param per_page:
         :param retries: Override the default retry configuration for this method
@@ -171,6 +181,8 @@ class Contractors(BaseSDK):
             city=city,
             specialty=specialty,
             min_permits=min_permits,
+            min_score=min_score,
+            sort=sort,
             page=page,
             per_page=per_page,
         )

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/health.py

@@ -182,7 +182,7 @@ class Health(BaseSDK):
 
         Public stats endpoint — no auth required.
         Returns aggregate coverage numbers for marketing/transparency.
-        Cached server-side for 5 minutes.
+        Cached server-side for 30 minutes.
 
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -265,7 +265,7 @@ class Health(BaseSDK):
 
         Public stats endpoint — no auth required.
         Returns aggregate coverage numbers for marketing/transparency.
-        Cached server-side for 5 minutes.
+        Cached server-side for 30 minutes.
 
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/models/__init__.py

@@ -5,12 +5,17 @@ from typing import Any, TYPE_CHECKING
 from permitstack.utils.dynamic_imports import lazy_getattr, lazy_dir
 
 if TYPE_CHECKING:
+    from .battery_retrofit_candidatesop import (
+        BatteryRetrofitCandidatesRequest,
+        BatteryRetrofitCandidatesRequestTypedDict,
+    )
     from .contractorprofile import ContractorProfile, ContractorProfileTypedDict
     from .contractorsearchresponse import (
         ContractorSearchResponse,
         ContractorSearchResponseTypedDict,
     )
     from .contractorsummary import ContractorSummary, ContractorSummaryTypedDict
+    from .coverageconfidence import CoverageConfidence, CoverageConfidenceTypedDict
     from .delete_webhookop import DeleteWebhookRequest, DeleteWebhookRequestTypedDict
     from .export_permitsop import ExportPermitsRequest, ExportPermitsRequestTypedDict
     from .get_contractor_permitsop import (
@@ -23,6 +28,10 @@ if TYPE_CHECKING:
         GetPermitsByAddressRequest,
         GetPermitsByAddressRequestTypedDict,
     )
+    from .get_property_by_parcelop import (
+        GetPropertyByParcelRequest,
+        GetPropertyByParcelRequestTypedDict,
+    )
     from .get_property_historyop import (
         GetPropertyHistoryRequest,
         GetPropertyHistoryRequestTypedDict,
@@ -31,14 +40,31 @@ if TYPE_CHECKING:
         GetWebhookSecretRequest,
         GetWebhookSecretRequestTypedDict,
     )
+    from .list_permit_eventsop import (
+        ListPermitEventsRequest,
+        ListPermitEventsRequestTypedDict,
+    )
+    from .orphan_recoveryop import OrphanRecoveryRequest, OrphanRecoveryRequestTypedDict
     from .permitdetail import PermitDetail, PermitDetailTypedDict
     from .permitenrichment import PermitEnrichment, PermitEnrichmentTypedDict
+    from .permiteventout import PermitEventOut, PermitEventOutTypedDict
+    from .permiteventsresponse import (
+        PermitEventsResponse,
+        PermitEventsResponseTypedDict,
+    )
     from .permitsearchresponse import (
         PermitSearchResponse,
         PermitSearchResponseTypedDict,
     )
     from .permitstatus import PermitStatus
     from .permitsummary import PermitSummary, PermitSummaryTypedDict
+    from .propertyhistoryresponse import (
+        PropertyHistoryResponse,
+        PropertyHistoryResponseTypedDict,
+    )
+    from .propertyquery import PropertyQuery, PropertyQueryTypedDict
+    from .propertysignals import PropertySignals, PropertySignalsTypedDict
+    from .propertysummary import PropertySummary, PropertySummaryTypedDict
     from .propertytype import PropertyType
     from .search_contractorsop import (
         SearchContractorsRequest,
@@ -58,6 +84,8 @@ if TYPE_CHECKING:
     from .webhookcreate import WebhookCreate, WebhookCreateTypedDict
 
 __all__ = [
+    "BatteryRetrofitCandidatesRequest",
+    "BatteryRetrofitCandidatesRequestTypedDict",
     "Context",
     "ContextTypedDict",
     "ContractorProfile",
@@ -66,6 +94,8 @@ __all__ = [
     "ContractorSearchResponseTypedDict",
     "ContractorSummary",
     "ContractorSummaryTypedDict",
+    "CoverageConfidence",
+    "CoverageConfidenceTypedDict",
     "DeleteWebhookRequest",
     "DeleteWebhookRequestTypedDict",
     "ExportPermitsRequest",
@@ -78,21 +108,39 @@ __all__ = [
     "GetPermitRequestTypedDict",
     "GetPermitsByAddressRequest",
     "GetPermitsByAddressRequestTypedDict",
+    "GetPropertyByParcelRequest",
+    "GetPropertyByParcelRequestTypedDict",
     "GetPropertyHistoryRequest",
     "GetPropertyHistoryRequestTypedDict",
     "GetWebhookSecretRequest",
     "GetWebhookSecretRequestTypedDict",
+    "ListPermitEventsRequest",
+    "ListPermitEventsRequestTypedDict",
     "Loc",
     "LocTypedDict",
+    "OrphanRecoveryRequest",
+    "OrphanRecoveryRequestTypedDict",
     "PermitDetail",
     "PermitDetailTypedDict",
     "PermitEnrichment",
     "PermitEnrichmentTypedDict",
+    "PermitEventOut",
+    "PermitEventOutTypedDict",
+    "PermitEventsResponse",
+    "PermitEventsResponseTypedDict",
     "PermitSearchResponse",
     "PermitSearchResponseTypedDict",
     "PermitStatus",
     "PermitSummary",
     "PermitSummaryTypedDict",
+    "PropertyHistoryResponse",
+    "PropertyHistoryResponseTypedDict",
+    "PropertyQuery",
+    "PropertyQueryTypedDict",
+    "PropertySignals",
+    "PropertySignalsTypedDict",
+    "PropertySummary",
+    "PropertySummaryTypedDict",
     "PropertyType",
     "SearchContractorsRequest",
     "SearchContractorsRequestTypedDict",
@@ -109,12 +157,16 @@ __all__ = [
 ]
 
 _dynamic_imports: dict[str, str] = {
+    "BatteryRetrofitCandidatesRequest": ".battery_retrofit_candidatesop",
+    "BatteryRetrofitCandidatesRequestTypedDict": ".battery_retrofit_candidatesop",
     "ContractorProfile": ".contractorprofile",
     "ContractorProfileTypedDict": ".contractorprofile",
     "ContractorSearchResponse": ".contractorsearchresponse",
     "ContractorSearchResponseTypedDict": ".contractorsearchresponse",
     "ContractorSummary": ".contractorsummary",
     "ContractorSummaryTypedDict": ".contractorsummary",
+    "CoverageConfidence": ".coverageconfidence",
+    "CoverageConfidenceTypedDict": ".coverageconfidence",
     "DeleteWebhookRequest": ".delete_webhookop",
     "DeleteWebhookRequestTypedDict": ".delete_webhookop",
     "ExportPermitsRequest": ".export_permitsop",
@@ -127,19 +179,37 @@ _dynamic_imports: dict[str, str] = {
     "GetPermitRequestTypedDict": ".get_permitop",
     "GetPermitsByAddressRequest": ".get_permits_by_addressop",
     "GetPermitsByAddressRequestTypedDict": ".get_permits_by_addressop",
+    "GetPropertyByParcelRequest": ".get_property_by_parcelop",
+    "GetPropertyByParcelRequestTypedDict": ".get_property_by_parcelop",
     "GetPropertyHistoryRequest": ".get_property_historyop",
     "GetPropertyHistoryRequestTypedDict": ".get_property_historyop",
     "GetWebhookSecretRequest": ".get_webhook_secretop",
     "GetWebhookSecretRequestTypedDict": ".get_webhook_secretop",
+    "ListPermitEventsRequest": ".list_permit_eventsop",
+    "ListPermitEventsRequestTypedDict": ".list_permit_eventsop",
+    "OrphanRecoveryRequest": ".orphan_recoveryop",
+    "OrphanRecoveryRequestTypedDict": ".orphan_recoveryop",
     "PermitDetail": ".permitdetail",
     "PermitDetailTypedDict": ".permitdetail",
     "PermitEnrichment": ".permitenrichment",
     "PermitEnrichmentTypedDict": ".permitenrichment",
+    "PermitEventOut": ".permiteventout",
+    "PermitEventOutTypedDict": ".permiteventout",
+    "PermitEventsResponse": ".permiteventsresponse",
+    "PermitEventsResponseTypedDict": ".permiteventsresponse",
     "PermitSearchResponse": ".permitsearchresponse",
     "PermitSearchResponseTypedDict": ".permitsearchresponse",
     "PermitStatus": ".permitstatus",
     "PermitSummary": ".permitsummary",
     "PermitSummaryTypedDict": ".permitsummary",
+    "PropertyHistoryResponse": ".propertyhistoryresponse",
+    "PropertyHistoryResponseTypedDict": ".propertyhistoryresponse",
+    "PropertyQuery": ".propertyquery",
+    "PropertyQueryTypedDict": ".propertyquery",
+    "PropertySignals": ".propertysignals",
+    "PropertySignalsTypedDict": ".propertysignals",
+    "PropertySummary": ".propertysummary",
+    "PropertySummaryTypedDict": ".propertysummary",
     "PropertyType": ".propertytype",
     "SearchContractorsRequest": ".search_contractorsop",
     "SearchContractorsRequestTypedDict": ".search_contractorsop",

permitstack-1.1.2/src/permitstack/models/battery_retrofit_candidatesop.py

@@ -0,0 +1,115 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from permitstack.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
+from permitstack.utils import FieldMetadata, QueryParamMetadata
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class BatteryRetrofitCandidatesRequestTypedDict(TypedDict):
+    state: NotRequired[Nullable[str]]
+    r"""2-letter state code"""
+    city: NotRequired[Nullable[str]]
+    r"""City name"""
+    zip_code: NotRequired[Nullable[str]]
+    r"""5-digit ZIP"""
+    jurisdiction: NotRequired[Nullable[str]]
+    r"""Jurisdiction name (partial)"""
+    min_age_years: NotRequired[float]
+    r"""Minimum age of the PV permit, in years"""
+    max_age_years: NotRequired[float]
+    r"""Maximum age of the PV permit, in years"""
+    page: NotRequired[int]
+    per_page: NotRequired[int]
+
+
+class BatteryRetrofitCandidatesRequest(BaseModel):
+    state: Annotated[
+        OptionalNullable[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = UNSET
+    r"""2-letter state code"""
+
+    city: Annotated[
+        OptionalNullable[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = UNSET
+    r"""City name"""
+
+    zip_code: Annotated[
+        OptionalNullable[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = UNSET
+    r"""5-digit ZIP"""
+
+    jurisdiction: Annotated[
+        OptionalNullable[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = UNSET
+    r"""Jurisdiction name (partial)"""
+
+    min_age_years: Annotated[
+        Optional[float],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 2
+    r"""Minimum age of the PV permit, in years"""
+
+    max_age_years: Annotated[
+        Optional[float],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 7
+    r"""Maximum age of the PV permit, in years"""
+
+    page: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 1
+
+    per_page: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 25
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "state",
+                "city",
+                "zip_code",
+                "jurisdiction",
+                "min_age_years",
+                "max_age_years",
+                "page",
+                "per_page",
+            ]
+        )
+        nullable_fields = set(["state", "city", "zip_code", "jurisdiction"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/models/contractorprofile.py

@@ -29,6 +29,8 @@ class ContractorProfileTypedDict(TypedDict):
     email: Nullable[str]
     address: Nullable[str]
     zip_code: Nullable[str]
+    score: NotRequired[Nullable[int]]
+    is_business: NotRequired[Nullable[bool]]
     recent_categories: NotRequired[Nullable[List[str]]]
     avg_project_value: NotRequired[Nullable[float]]
 
@@ -62,13 +64,19 @@ class ContractorProfile(BaseModel):
 
     zip_code: Nullable[str]
 
+    score: OptionalNullable[int] = UNSET
+
+    is_business: OptionalNullable[bool] = UNSET
+
     recent_categories: OptionalNullable[List[str]] = UNSET
 
     avg_project_value: OptionalNullable[float] = UNSET
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = set(["recent_categories", "avg_project_value"])
+        optional_fields = set(
+            ["score", "is_business", "recent_categories", "avg_project_value"]
+        )
         nullable_fields = set(
             [
                 "license_number",
@@ -78,6 +86,8 @@ class ContractorProfile(BaseModel):
                 "first_permit_date",
                 "last_permit_date",
                 "specialties",
+                "score",
+                "is_business",
                 "phone",
                 "email",
                 "address",

{permitstack-1.1.0 → permitstack-1.1.2}/src/permitstack/models/contractorsummary.py

@@ -2,10 +2,16 @@
 
 from __future__ import annotations
 from datetime import date
-from permitstack.types import BaseModel, Nullable, UNSET_SENTINEL
+from permitstack.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
 from pydantic import model_serializer
 from typing import List
-from typing_extensions import TypedDict
+from typing_extensions import NotRequired, TypedDict
 
 
 class ContractorSummaryTypedDict(TypedDict):
@@ -19,6 +25,8 @@ class ContractorSummaryTypedDict(TypedDict):
     first_permit_date: Nullable[date]
     last_permit_date: Nullable[date]
     specialties: Nullable[List[str]]
+    score: NotRequired[Nullable[int]]
+    is_business: NotRequired[Nullable[bool]]
 
 
 class ContractorSummary(BaseModel):
@@ -42,16 +50,43 @@ class ContractorSummary(BaseModel):
 
     specialties: Nullable[List[str]]
 
+    score: OptionalNullable[int] = UNSET
+
+    is_business: OptionalNullable[bool] = UNSET
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
+        optional_fields = set(["score", "is_business"])
+        nullable_fields = set(
+            [
+                "license_number",
+                "license_state",
+                "city",
+                "state",
+                "first_permit_date",
+                "last_permit_date",
+                "specialties",
+                "score",
+                "is_business",
+            ]
+        )
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k, serialized.get(n))
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
 
             if val != UNSET_SENTINEL:
-                m[k] = val
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
 
         return m

permitstack-1.1.2/src/permitstack/models/coverageconfidence.py

@@ -0,0 +1,78 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from permitstack.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
+from pydantic import model_serializer
+from typing_extensions import NotRequired, TypedDict
+
+
+class CoverageConfidenceTypedDict(TypedDict):
+    r"""Honest read on whether a `found: false` is meaningful or just missing data.
+
+    The wedge competitors won't ship: a 'no permit on record' is only useful if we
+    actually cover that jurisdiction. We say so explicitly so an automated (e.g.
+    underwriting) workflow can tell UNKNOWN apart from genuinely-no-work.
+    """
+
+    confidence: str
+    covered: bool
+    note: str
+    jurisdiction: NotRequired[Nullable[str]]
+    data_status: NotRequired[Nullable[str]]
+    jurisdiction_permit_count: NotRequired[Nullable[int]]
+
+
+class CoverageConfidence(BaseModel):
+    r"""Honest read on whether a `found: false` is meaningful or just missing data.
+
+    The wedge competitors won't ship: a 'no permit on record' is only useful if we
+    actually cover that jurisdiction. We say so explicitly so an automated (e.g.
+    underwriting) workflow can tell UNKNOWN apart from genuinely-no-work.
+    """
+
+    confidence: str
+
+    covered: bool
+
+    note: str
+
+    jurisdiction: OptionalNullable[str] = UNSET
+
+    data_status: OptionalNullable[str] = UNSET
+
+    jurisdiction_permit_count: OptionalNullable[int] = UNSET
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            ["jurisdiction", "data_status", "jurisdiction_permit_count"]
+        )
+        nullable_fields = set(
+            ["jurisdiction", "data_status", "jurisdiction_permit_count"]
+        )
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m