# Intl Address Verification

## Verify

`intl_address_verification.verify(IntlAddressVerificationVerifyParams**kwargs)  -> IntlAddressVerificationVerifyResponse`

**post** `/v1/intl_addver/verifications`

Verify and standardize an international address.

- Supports both structured and freeform address inputs.
- Specify `includeDetails=true` to get additional details as per the `IntlDetails` schema.
- Uses 1 lookup.

### Parameters

- `address: StructuredAddressInputAddress`

  - `country: str`

    The country code (ISO 3166-1 alpha-2 or alpha-3).

  - `line1: str`

    The first line of the address (e.g., street address, building, etc.).

  - `postal_or_zip: str`

    The postal or ZIP code.

  - `province_or_state: str`

    The administrative area (e.g., state, province, region).

  - `city: Optional[str]`

    The city, town, or locality of the address.

  - `line2: Optional[str]`

    The second line of the address (e.g., apartment, suite, etc.).

  - `line3: Optional[str]`

    The third line of the address (e.g., additional locality or delivery info).

  - `line4: Optional[str]`

    The fourth line of the address (e.g., further address details).

- `geo_data: Optional[bool]`

- `include_details: Optional[bool]`

- `proper_case: Optional[bool]`

### Returns

- `class IntlAddressVerificationVerifyResponse: …`

  - `data: Data`

    The result of a verified international address.

    - `city: str`

      The city or locality.

    - `country: str`

      The country code (ISO 3166-1 alpha-2).

    - `line1: str`

      The first address line.

    - `postal_or_zip: str`

      The postal or ZIP code.

    - `province_or_state: str`

      The province or state.

    - `country_name: Optional[str]`

      The full country name.

    - `details: Optional[DataDetails]`

      Additional details about the verified address, such as premise, thoroughfare, and locality.

      - `building: Optional[str]`

        The building name or number.

      - `building_type: Optional[str]`

        The type of building (e.g., apartment, office).

      - `city_name: Optional[str]`

        The full city name.

      - `city_secondary: Optional[str]`

        Secondary city information.

      - `city_type: Optional[str]`

        The type of city (e.g., city, town, village).

      - `delivery_address: Optional[str]`

        The full delivery address.

      - `dependent_locality: Optional[str]`

        The dependent locality (UK addresses).

      - `double_dependent_locality: Optional[str]`

        The double dependent locality (UK addresses).

      - `organization: Optional[str]`

        The organization or company name.

      - `postal_or_zip_primary: Optional[str]`

        The primary part of the postal or ZIP code.

      - `postal_or_zip_secondary: Optional[str]`

        The secondary part of the postal or ZIP code.

      - `post_box: Optional[str]`

        The post box number.

      - `premise: Optional[str]`

        The premise name or number.

      - `premise_number: Optional[str]`

        The premise number.

      - `premise_secondary: Optional[str]`

        Secondary premise information.

      - `premise_type: Optional[str]`

        The type of premise (e.g., house, flat).

      - `province_or_state_name: Optional[str]`

        The full name of the province or state.

      - `province_or_state_type: Optional[str]`

        The type of province or state (e.g., province, state, region).

      - `street: Optional[str]`

        The street name.

      - `street_post_direction: Optional[str]`

        The directional suffix for the street (e.g., N, S, E, W).

      - `street_pre_direction: Optional[str]`

        The directional prefix for the street (e.g., N, S, E, W).

      - `street_type: Optional[str]`

        The type of street (e.g., St, Ave, Blvd).

      - `sub_administrative_area: Optional[str]`

        The sub-administrative area.

      - `sub_building: Optional[str]`

        The sub-building name or number (e.g., unit, suite).

      - `sub_building_floor: Optional[str]`

        The floor of the sub-building.

      - `sub_building_number: Optional[str]`

        The sub-building number.

      - `sub_building_type: Optional[str]`

        The type of sub-building (e.g., floor, wing).

      - `sub_street: Optional[str]`

        The sub-street name.

      - `sub_street_post_direction: Optional[str]`

        The directional suffix for the sub-street.

      - `sub_street_pre_direction: Optional[str]`

        The directional prefix for the sub-street.

      - `sub_street_type: Optional[str]`

        The type of sub-street.

      - `super_administrative_area: Optional[str]`

        The super-administrative area.

      - `telephone: Optional[str]`

        The telephone number associated with the address.

    - `errors: Optional[Errors]`

      Errors encountered during address verification.

      - `city: Optional[List[str]]`

        Errors related to the city.

      - `generic: Optional[List[str]]`

        Generic errors not tied to a specific field.

      - `line1: Optional[List[str]]`

        Errors related to the first address line.

      - `line2: Optional[List[str]]`

        Errors related to the second address line.

      - `postal_or_zip: Optional[List[str]]`

        Errors related to the postal or ZIP code.

      - `province_or_state: Optional[List[str]]`

        Errors related to the province or state.

    - `firm_name: Optional[str]`

      The firm or company name, if available.

    - `formatted_address: Optional[str]`

      The formatted address string.

    - `geo_data: Optional[DataGeoData]`

      Geocoding result for the verified address.

      - `geo_accuracy: Optional[str]`

        The geocode accuracy.

      - `latitude: Optional[str]`

        The latitude of the address.

      - `longitude: Optional[str]`

        The longitude of the address.

    - `line2: Optional[str]`

      The second address line.

    - `line3: Optional[str]`

      The third address line, if available.

    - `status: Optional[Status]`

      The verification status of an address.

      - `"verified"`

      - `"corrected"`

      - `"failed"`

    - `summary: Optional[DataSummary]`

      A summary of the verification process and match levels.

      - `context_identification_match_level: Optional[str]`

        Context identification match level.

      - `lexicon_identification_match_level: Optional[str]`

        Lexicon identification match level.

      - `match_score: Optional[float]`

        The match score (0-100).

      - `message: Optional[str]`

        Additional message about the verification.

      - `parsing_status: Optional[str]`

        The parsing status of the address.

      - `post_code_status: Optional[str]`

        The status of the postal code.

      - `post_processed_verification_match_level: Optional[str]`

        The match level after post-processing.

      - `pre_processed_verification_match_level: Optional[str]`

        The match level before post-processing.

      - `verification_status: Optional[str]`

        The overall verification status.

    - `zip_plus4: Optional[str]`

      The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Example

```python
import os
from postgrid import PostGrid

client = PostGrid(
    address_verification_api_key=os.environ.get("POSTGRID_ADDRESS_VERIFICATION_API_KEY"),  # This is the default and can be omitted
)
response = client.intl_address_verification.verify(
    address={},
)
print(response.data)
```

#### Response

```json
{
  "status": "success",
  "message": "International address verified successfully.",
  "data": {
    "city": "Scarborough",
    "country": "CA",
    "details": {
      "premise": "31"
    },
    "formattedAddress": "31 Fl,scarborough On",
    "geoData": {
      "latitude": "43.761961",
      "longitude": "-79.245693",
      "geoAccuracy": "A2"
    },
    "line1": "31 Fl",
    "line2": "Scarborough On",
    "provinceOrState": "ON",
    "postalOrZip": "",
    "summary": {
      "verificationStatus": "partially_verified",
      "postProcessedVerificationMatchLevel": "city",
      "preProcessedVerificationMatchLevel": "city",
      "parsingStatus": "unable_to_parse",
      "lexiconIdentificationMatchLevel": "city",
      "contextIdentificationMatchLevel": "premise_or_building",
      "postCodeStatus": "postal_code_primary_empty",
      "matchScore": 100
    }
  }
}
```

## Batch Verification

`intl_address_verification.batch_verification(IntlAddressVerificationBatchVerificationParams**kwargs)  -> IntlAddressVerificationBatchVerificationResponse`

**post** `/v1/intl_addver/verifications/batch`

Verify a batch of international addresses in a single request.
Each address can be freeform or structured, matching the same input formats
accepted by the single verification endpoint.

- Uses 1 lookup per address.
- Requires a secret API key.
- Returns results in the same order as the input addresses.
- If an individual address fails, its result will contain an `error` field
  rather than a `verifiedAddress`.

### Parameters

- `addresses: Iterable[Address]`

  Array of addresses to verify. Each item can be a freeform string or a structured address object.

  - `class AddressStructuredAddressInput: …`

    Input model for structured international address verification.

    - `address: AddressStructuredAddressInputAddress`

      - `country: str`

        The country code (ISO 3166-1 alpha-2 or alpha-3).

      - `line1: str`

        The first line of the address (e.g., street address, building, etc.).

      - `postal_or_zip: str`

        The postal or ZIP code.

      - `province_or_state: str`

        The administrative area (e.g., state, province, region).

      - `city: Optional[str]`

        The city, town, or locality of the address.

      - `line2: Optional[str]`

        The second line of the address (e.g., apartment, suite, etc.).

      - `line3: Optional[str]`

        The third line of the address (e.g., additional locality or delivery info).

      - `line4: Optional[str]`

        The fourth line of the address (e.g., further address details).

  - `class AddressFreeformAddressInput: …`

    Input model for freeform international address verification.

    - `address: str`

      The full address as a single string.

- `geo_data: Optional[bool]`

- `include_details: Optional[bool]`

- `proper_case: Optional[bool]`

- `use_enhanced_china_dataset: Optional[bool]`

### Returns

- `class IntlAddressVerificationBatchVerificationResponse: …`

  - `data: Data`

    - `results: List[DataResult]`

      - `error: Optional[str]`

        An error message for this address. Present when verification failed.

      - `verified_address: Optional[DataResultVerifiedAddress]`

        The result of a verified international address.

        - `city: str`

          The city or locality.

        - `country: str`

          The country code (ISO 3166-1 alpha-2).

        - `line1: str`

          The first address line.

        - `postal_or_zip: str`

          The postal or ZIP code.

        - `province_or_state: str`

          The province or state.

        - `country_name: Optional[str]`

          The full country name.

        - `details: Optional[DataResultVerifiedAddressDetails]`

          Additional details about the verified address, such as premise, thoroughfare, and locality.

          - `building: Optional[str]`

            The building name or number.

          - `building_type: Optional[str]`

            The type of building (e.g., apartment, office).

          - `city_name: Optional[str]`

            The full city name.

          - `city_secondary: Optional[str]`

            Secondary city information.

          - `city_type: Optional[str]`

            The type of city (e.g., city, town, village).

          - `delivery_address: Optional[str]`

            The full delivery address.

          - `dependent_locality: Optional[str]`

            The dependent locality (UK addresses).

          - `double_dependent_locality: Optional[str]`

            The double dependent locality (UK addresses).

          - `organization: Optional[str]`

            The organization or company name.

          - `postal_or_zip_primary: Optional[str]`

            The primary part of the postal or ZIP code.

          - `postal_or_zip_secondary: Optional[str]`

            The secondary part of the postal or ZIP code.

          - `post_box: Optional[str]`

            The post box number.

          - `premise: Optional[str]`

            The premise name or number.

          - `premise_number: Optional[str]`

            The premise number.

          - `premise_secondary: Optional[str]`

            Secondary premise information.

          - `premise_type: Optional[str]`

            The type of premise (e.g., house, flat).

          - `province_or_state_name: Optional[str]`

            The full name of the province or state.

          - `province_or_state_type: Optional[str]`

            The type of province or state (e.g., province, state, region).

          - `street: Optional[str]`

            The street name.

          - `street_post_direction: Optional[str]`

            The directional suffix for the street (e.g., N, S, E, W).

          - `street_pre_direction: Optional[str]`

            The directional prefix for the street (e.g., N, S, E, W).

          - `street_type: Optional[str]`

            The type of street (e.g., St, Ave, Blvd).

          - `sub_administrative_area: Optional[str]`

            The sub-administrative area.

          - `sub_building: Optional[str]`

            The sub-building name or number (e.g., unit, suite).

          - `sub_building_floor: Optional[str]`

            The floor of the sub-building.

          - `sub_building_number: Optional[str]`

            The sub-building number.

          - `sub_building_type: Optional[str]`

            The type of sub-building (e.g., floor, wing).

          - `sub_street: Optional[str]`

            The sub-street name.

          - `sub_street_post_direction: Optional[str]`

            The directional suffix for the sub-street.

          - `sub_street_pre_direction: Optional[str]`

            The directional prefix for the sub-street.

          - `sub_street_type: Optional[str]`

            The type of sub-street.

          - `super_administrative_area: Optional[str]`

            The super-administrative area.

          - `telephone: Optional[str]`

            The telephone number associated with the address.

        - `errors: Optional[Errors]`

          Errors encountered during address verification.

          - `city: Optional[List[str]]`

            Errors related to the city.

          - `generic: Optional[List[str]]`

            Generic errors not tied to a specific field.

          - `line1: Optional[List[str]]`

            Errors related to the first address line.

          - `line2: Optional[List[str]]`

            Errors related to the second address line.

          - `postal_or_zip: Optional[List[str]]`

            Errors related to the postal or ZIP code.

          - `province_or_state: Optional[List[str]]`

            Errors related to the province or state.

        - `firm_name: Optional[str]`

          The firm or company name, if available.

        - `formatted_address: Optional[str]`

          The formatted address string.

        - `geo_data: Optional[DataResultVerifiedAddressGeoData]`

          Geocoding result for the verified address.

          - `geo_accuracy: Optional[str]`

            The geocode accuracy.

          - `latitude: Optional[str]`

            The latitude of the address.

          - `longitude: Optional[str]`

            The longitude of the address.

        - `line2: Optional[str]`

          The second address line.

        - `line3: Optional[str]`

          The third address line, if available.

        - `status: Optional[Status]`

          The verification status of an address.

          - `"verified"`

          - `"corrected"`

          - `"failed"`

        - `summary: Optional[DataResultVerifiedAddressSummary]`

          A summary of the verification process and match levels.

          - `context_identification_match_level: Optional[str]`

            Context identification match level.

          - `lexicon_identification_match_level: Optional[str]`

            Lexicon identification match level.

          - `match_score: Optional[float]`

            The match score (0-100).

          - `message: Optional[str]`

            Additional message about the verification.

          - `parsing_status: Optional[str]`

            The parsing status of the address.

          - `post_code_status: Optional[str]`

            The status of the postal code.

          - `post_processed_verification_match_level: Optional[str]`

            The match level after post-processing.

          - `pre_processed_verification_match_level: Optional[str]`

            The match level before post-processing.

          - `verification_status: Optional[str]`

            The overall verification status.

        - `zip_plus4: Optional[str]`

          The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Example

```python
import os
from postgrid import PostGrid

client = PostGrid(
    address_verification_api_key=os.environ.get("POSTGRID_ADDRESS_VERIFICATION_API_KEY"),  # This is the default and can be omitted
)
response = client.intl_address_verification.batch_verification(
    addresses=[{
        "address": {
            "country": "country",
            "line1": "line1",
            "postal_or_zip": "postalOrZip",
            "province_or_state": "provinceOrState",
        }
    }],
)
print(response.data)
```

#### Response

```json
{
  "data": {
    "results": [
      {
        "error": "error",
        "verifiedAddress": {
          "city": "city",
          "country": "country",
          "line1": "line1",
          "postalOrZip": "postalOrZip",
          "provinceOrState": "provinceOrState",
          "countryName": "countryName",
          "details": {
            "building": "building",
            "buildingType": "buildingType",
            "cityName": "cityName",
            "citySecondary": "citySecondary",
            "cityType": "cityType",
            "deliveryAddress": "deliveryAddress",
            "dependentLocality": "dependentLocality",
            "doubleDependentLocality": "doubleDependentLocality",
            "organization": "organization",
            "postalOrZipPrimary": "postalOrZipPrimary",
            "postalOrZipSecondary": "postalOrZipSecondary",
            "postBox": "postBox",
            "premise": "premise",
            "premiseNumber": "premiseNumber",
            "premiseSecondary": "premiseSecondary",
            "premiseType": "premiseType",
            "provinceOrStateName": "provinceOrStateName",
            "provinceOrStateType": "provinceOrStateType",
            "street": "street",
            "streetPostDirection": "streetPostDirection",
            "streetPreDirection": "streetPreDirection",
            "streetType": "streetType",
            "subAdministrativeArea": "subAdministrativeArea",
            "subBuilding": "subBuilding",
            "SubBuildingFloor": "SubBuildingFloor",
            "subBuildingNumber": "subBuildingNumber",
            "subBuildingType": "subBuildingType",
            "subStreet": "subStreet",
            "subStreetPostDirection": "subStreetPostDirection",
            "subStreetPreDirection": "subStreetPreDirection",
            "subStreetType": "subStreetType",
            "superAdministrativeArea": "superAdministrativeArea",
            "telephone": "telephone"
          },
          "errors": {
            "city": [
              "string"
            ],
            "generic": [
              "string"
            ],
            "line1": [
              "string"
            ],
            "line2": [
              "string"
            ],
            "postalOrZip": [
              "string"
            ],
            "provinceOrState": [
              "string"
            ]
          },
          "firmName": "firmName",
          "formattedAddress": "formattedAddress",
          "geoData": {
            "geoAccuracy": "geoAccuracy",
            "latitude": "latitude",
            "longitude": "longitude"
          },
          "line2": "line2",
          "line3": "line3",
          "status": "verified",
          "summary": {
            "contextIdentificationMatchLevel": "contextIdentificationMatchLevel",
            "lexiconIdentificationMatchLevel": "lexiconIdentificationMatchLevel",
            "matchScore": 0,
            "message": "message",
            "parsingStatus": "parsingStatus",
            "postCodeStatus": "postCodeStatus",
            "postProcessedVerificationMatchLevel": "postProcessedVerificationMatchLevel",
            "preProcessedVerificationMatchLevel": "preProcessedVerificationMatchLevel",
            "verificationStatus": "verificationStatus"
          },
          "zipPlus4": "zipPlus4"
        }
      }
    ]
  },
  "message": "message",
  "status": "success"
}
```

## Get Autocomplete Previews

`intl_address_verification.get_autocomplete_previews(IntlAddressVerificationGetAutocompletePreviewsParams**kwargs)  -> IntlAddressVerificationGetAutocompletePreviewsResponse`

**get** `/v1/intl_addver/completions`

Returns address completion previews for a partial address string, suitable
for populating an autocomplete dropdown.

**Regular mode** — supply `partialStreet` to search by partial street address.
Results may include `Address` types (resolvable directly) and `Container` types
(buildings/complexes that require a follow-up call).

**Advanced mode** — supply `advanced=true` and a `container` ID (from a previous
regular call) to drill into a building or complex and retrieve individual unit addresses.

Results with `type: "Address"` can be fully resolved by passing their `id`
to `POST /completions`.

- Does not consume a lookup.

### Parameters

- `advanced: Optional[bool]`

- `city_filter: Optional[str]`

- `container: Optional[str]`

- `countries_filter: Optional[str]`

- `disable_ip_biasing: Optional[bool]`

- `language: Optional[str]`

- `limit: Optional[int]`

- `partial_street: Optional[str]`

- `postal_or_zip_filter: Optional[str]`

- `standard_fallback: Optional[bool]`

- `street_filter: Optional[str]`

- `use_enhanced_china_dataset: Optional[bool]`

### Returns

- `class IntlAddressVerificationGetAutocompletePreviewsResponse: …`

  - `data: List[Data]`

    - `id: Optional[str]`

      The unique identifier for this result. Pass this to `POST /completions`
      to retrieve the full address. If the `type` is `Container`, pass it as
      the `container` parameter to `GET /completions` to drill down further.

    - `description: Optional[str]`

      A secondary description of the result (e.g. city and country).

    - `error: Optional[str]`

      An error message if the lookup failed for this result.

    - `highlight: Optional[str]`

      Character ranges within `text` that match the search input, for bolding in UI.

    - `text: Optional[str]`

      The human-readable address suggestion text.

    - `type: Optional[str]`

      The type of result. `Address` means this can be resolved directly via
      `POST /completions`. `Container` means the result represents a building
      or complex — perform another `GET /completions` with this `id` as
      `container` to get individual unit addresses.

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Example

```python
import os
from postgrid import PostGrid

client = PostGrid(
    address_verification_api_key=os.environ.get("POSTGRID_ADDRESS_VERIFICATION_API_KEY"),  # This is the default and can be omitted
)
response = client.intl_address_verification.get_autocomplete_previews()
print(response.data)
```

#### Response

```json
{
  "status": "success",
  "message": "Address previews retrieved successfully",
  "data": [
    {
      "id": "GB|RM|A|54186236",
      "type": "Address",
      "text": "Flat 1, One Canada Square",
      "description": "London, E14 5AB"
    }
  ]
}
```

## Get Autocomplete Advanced Previews

`intl_address_verification.get_autocomplete_advanced_previews(IntlAddressVerificationGetAutocompleteAdvancedPreviewsParams**kwargs)  -> IntlAddressVerificationGetAutocompleteAdvancedPreviewsResponse`

**get** `/v1/intl_addver/completions`

Returns address completion previews for a partial address string, suitable
for populating an autocomplete dropdown.

**Regular mode** — supply `partialStreet` to search by partial street address.
Results may include `Address` types (resolvable directly) and `Container` types
(buildings/complexes that require a follow-up call).

**Advanced mode** — supply `advanced=true` and a `container` ID (from a previous
regular call) to drill into a building or complex and retrieve individual unit addresses.

Results with `type: "Address"` can be fully resolved by passing their `id`
to `POST /completions`.

- Does not consume a lookup.

### Parameters

- `advanced: Optional[bool]`

- `city_filter: Optional[str]`

- `container: Optional[str]`

- `countries_filter: Optional[str]`

- `disable_ip_biasing: Optional[bool]`

- `language: Optional[str]`

- `limit: Optional[int]`

- `partial_street: Optional[str]`

- `postal_or_zip_filter: Optional[str]`

- `standard_fallback: Optional[bool]`

- `street_filter: Optional[str]`

- `use_enhanced_china_dataset: Optional[bool]`

### Returns

- `class IntlAddressVerificationGetAutocompleteAdvancedPreviewsResponse: …`

  - `data: List[Data]`

    - `id: Optional[str]`

      The unique identifier for this result. Pass this to `POST /completions`
      to retrieve the full address. If the `type` is `Container`, pass it as
      the `container` parameter to `GET /completions` to drill down further.

    - `description: Optional[str]`

      A secondary description of the result (e.g. city and country).

    - `error: Optional[str]`

      An error message if the lookup failed for this result.

    - `highlight: Optional[str]`

      Character ranges within `text` that match the search input, for bolding in UI.

    - `text: Optional[str]`

      The human-readable address suggestion text.

    - `type: Optional[str]`

      The type of result. `Address` means this can be resolved directly via
      `POST /completions`. `Container` means the result represents a building
      or complex — perform another `GET /completions` with this `id` as
      `container` to get individual unit addresses.

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Example

```python
import os
from postgrid import PostGrid

client = PostGrid(
    address_verification_api_key=os.environ.get("POSTGRID_ADDRESS_VERIFICATION_API_KEY"),  # This is the default and can be omitted
)
response = client.intl_address_verification.get_autocomplete_advanced_previews()
print(response.data)
```

#### Response

```json
{
  "status": "success",
  "message": "Address previews retrieved successfully",
  "data": [
    {
      "id": "GB|RM|A|54186236",
      "type": "Address",
      "text": "Flat 1, One Canada Square",
      "description": "London, E14 5AB"
    }
  ]
}
```

## Autocomplete

`intl_address_verification.autocomplete(IntlAddressVerificationAutocompleteParams**kwargs)  -> IntlAddressVerificationAutocompleteResponse`

**post** `/v1/intl_addver/completions`

Resolves an address preview `id` (from `GET /completions`) into a full address.

Optionally verifies the resolved address through the standard US/CA verifier
when `verify=true` is supplied and the address is in the US or Canada.

- Uses 1 lookup per call.
- When `verify=true` resolves a US or CA address, the response will be a
  `VerifiedAddress` instead of an `IntlAddressCompletion`.

### Parameters

- `id: str`

- `include_details: Optional[bool]`

- `proper_case: Optional[bool]`

- `use_enhanced_china_dataset: Optional[bool]`

- `verify: Optional[bool]`

### Returns

- `class IntlAddressVerificationAutocompleteResponse: …`

  - `data: Data`

    A fully resolved international address returned by `POST /completions`.

    - `class DataIntlAddressCompletion: …`

      A fully resolved international address returned by `POST /completions`.

      - `building: Optional[str]`

        The building name, if applicable.

      - `city: Optional[str]`

        The city or locality.

      - `company: Optional[str]`

        The company or organization name, if applicable.

      - `country: Optional[str]`

        The country name.

      - `country_code: Optional[str]`

        The ISO 2-letter country code.

      - `department: Optional[str]`

        The department or floor, if applicable.

      - `error: Optional[str]`

        An error message if resolution failed.

      - `formatted_address: Optional[str]`

        The full formatted address string.

      - `line1: Optional[str]`

        The first address line.

      - `line2: Optional[str]`

        The second address line.

      - `line3: Optional[str]`

        The third address line.

      - `line4: Optional[str]`

        The fourth address line.

      - `postal_or_zip: Optional[str]`

        The postal or ZIP code.

      - `province_code: Optional[str]`

        The province or state code.

      - `province_or_state: Optional[str]`

        The province or state name.

    - `class DataVerifiedAddress: …`

      The result of a verified international address.

      - `city: str`

        The city or locality.

      - `country: str`

        The country code (ISO 3166-1 alpha-2).

      - `line1: str`

        The first address line.

      - `postal_or_zip: str`

        The postal or ZIP code.

      - `province_or_state: str`

        The province or state.

      - `country_name: Optional[str]`

        The full country name.

      - `details: Optional[DataVerifiedAddressDetails]`

        Additional details about the verified address, such as premise, thoroughfare, and locality.

        - `building: Optional[str]`

          The building name or number.

        - `building_type: Optional[str]`

          The type of building (e.g., apartment, office).

        - `city_name: Optional[str]`

          The full city name.

        - `city_secondary: Optional[str]`

          Secondary city information.

        - `city_type: Optional[str]`

          The type of city (e.g., city, town, village).

        - `delivery_address: Optional[str]`

          The full delivery address.

        - `dependent_locality: Optional[str]`

          The dependent locality (UK addresses).

        - `double_dependent_locality: Optional[str]`

          The double dependent locality (UK addresses).

        - `organization: Optional[str]`

          The organization or company name.

        - `postal_or_zip_primary: Optional[str]`

          The primary part of the postal or ZIP code.

        - `postal_or_zip_secondary: Optional[str]`

          The secondary part of the postal or ZIP code.

        - `post_box: Optional[str]`

          The post box number.

        - `premise: Optional[str]`

          The premise name or number.

        - `premise_number: Optional[str]`

          The premise number.

        - `premise_secondary: Optional[str]`

          Secondary premise information.

        - `premise_type: Optional[str]`

          The type of premise (e.g., house, flat).

        - `province_or_state_name: Optional[str]`

          The full name of the province or state.

        - `province_or_state_type: Optional[str]`

          The type of province or state (e.g., province, state, region).

        - `street: Optional[str]`

          The street name.

        - `street_post_direction: Optional[str]`

          The directional suffix for the street (e.g., N, S, E, W).

        - `street_pre_direction: Optional[str]`

          The directional prefix for the street (e.g., N, S, E, W).

        - `street_type: Optional[str]`

          The type of street (e.g., St, Ave, Blvd).

        - `sub_administrative_area: Optional[str]`

          The sub-administrative area.

        - `sub_building: Optional[str]`

          The sub-building name or number (e.g., unit, suite).

        - `sub_building_floor: Optional[str]`

          The floor of the sub-building.

        - `sub_building_number: Optional[str]`

          The sub-building number.

        - `sub_building_type: Optional[str]`

          The type of sub-building (e.g., floor, wing).

        - `sub_street: Optional[str]`

          The sub-street name.

        - `sub_street_post_direction: Optional[str]`

          The directional suffix for the sub-street.

        - `sub_street_pre_direction: Optional[str]`

          The directional prefix for the sub-street.

        - `sub_street_type: Optional[str]`

          The type of sub-street.

        - `super_administrative_area: Optional[str]`

          The super-administrative area.

        - `telephone: Optional[str]`

          The telephone number associated with the address.

      - `errors: Optional[Errors]`

        Errors encountered during address verification.

        - `city: Optional[List[str]]`

          Errors related to the city.

        - `generic: Optional[List[str]]`

          Generic errors not tied to a specific field.

        - `line1: Optional[List[str]]`

          Errors related to the first address line.

        - `line2: Optional[List[str]]`

          Errors related to the second address line.

        - `postal_or_zip: Optional[List[str]]`

          Errors related to the postal or ZIP code.

        - `province_or_state: Optional[List[str]]`

          Errors related to the province or state.

      - `firm_name: Optional[str]`

        The firm or company name, if available.

      - `formatted_address: Optional[str]`

        The formatted address string.

      - `geo_data: Optional[DataVerifiedAddressGeoData]`

        Geocoding result for the verified address.

        - `geo_accuracy: Optional[str]`

          The geocode accuracy.

        - `latitude: Optional[str]`

          The latitude of the address.

        - `longitude: Optional[str]`

          The longitude of the address.

      - `line2: Optional[str]`

        The second address line.

      - `line3: Optional[str]`

        The third address line, if available.

      - `status: Optional[Status]`

        The verification status of an address.

        - `"verified"`

        - `"corrected"`

        - `"failed"`

      - `summary: Optional[DataVerifiedAddressSummary]`

        A summary of the verification process and match levels.

        - `context_identification_match_level: Optional[str]`

          Context identification match level.

        - `lexicon_identification_match_level: Optional[str]`

          Lexicon identification match level.

        - `match_score: Optional[float]`

          The match score (0-100).

        - `message: Optional[str]`

          Additional message about the verification.

        - `parsing_status: Optional[str]`

          The parsing status of the address.

        - `post_code_status: Optional[str]`

          The status of the postal code.

        - `post_processed_verification_match_level: Optional[str]`

          The match level after post-processing.

        - `pre_processed_verification_match_level: Optional[str]`

          The match level before post-processing.

        - `verification_status: Optional[str]`

          The overall verification status.

      - `zip_plus4: Optional[str]`

        The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Example

```python
import os
from postgrid import PostGrid

client = PostGrid(
    address_verification_api_key=os.environ.get("POSTGRID_ADDRESS_VERIFICATION_API_KEY"),  # This is the default and can be omitted
)
response = client.intl_address_verification.autocomplete(
    id="id",
)
print(response.data)
```

#### Response

```json
{
  "data": {
    "building": "building",
    "city": "city",
    "company": "company",
    "country": "country",
    "countryCode": "countryCode",
    "department": "department",
    "error": "error",
    "formattedAddress": "formattedAddress",
    "line1": "line1",
    "line2": "line2",
    "line3": "line3",
    "line4": "line4",
    "postalOrZip": "postalOrZip",
    "provinceCode": "provinceCode",
    "provinceOrState": "provinceOrState"
  },
  "message": "message",
  "status": "success"
}
```

## Domain Types

### Intl Address Verification Verify Response

- `class IntlAddressVerificationVerifyResponse: …`

  - `data: Data`

    The result of a verified international address.

    - `city: str`

      The city or locality.

    - `country: str`

      The country code (ISO 3166-1 alpha-2).

    - `line1: str`

      The first address line.

    - `postal_or_zip: str`

      The postal or ZIP code.

    - `province_or_state: str`

      The province or state.

    - `country_name: Optional[str]`

      The full country name.

    - `details: Optional[DataDetails]`

      Additional details about the verified address, such as premise, thoroughfare, and locality.

      - `building: Optional[str]`

        The building name or number.

      - `building_type: Optional[str]`

        The type of building (e.g., apartment, office).

      - `city_name: Optional[str]`

        The full city name.

      - `city_secondary: Optional[str]`

        Secondary city information.

      - `city_type: Optional[str]`

        The type of city (e.g., city, town, village).

      - `delivery_address: Optional[str]`

        The full delivery address.

      - `dependent_locality: Optional[str]`

        The dependent locality (UK addresses).

      - `double_dependent_locality: Optional[str]`

        The double dependent locality (UK addresses).

      - `organization: Optional[str]`

        The organization or company name.

      - `postal_or_zip_primary: Optional[str]`

        The primary part of the postal or ZIP code.

      - `postal_or_zip_secondary: Optional[str]`

        The secondary part of the postal or ZIP code.

      - `post_box: Optional[str]`

        The post box number.

      - `premise: Optional[str]`

        The premise name or number.

      - `premise_number: Optional[str]`

        The premise number.

      - `premise_secondary: Optional[str]`

        Secondary premise information.

      - `premise_type: Optional[str]`

        The type of premise (e.g., house, flat).

      - `province_or_state_name: Optional[str]`

        The full name of the province or state.

      - `province_or_state_type: Optional[str]`

        The type of province or state (e.g., province, state, region).

      - `street: Optional[str]`

        The street name.

      - `street_post_direction: Optional[str]`

        The directional suffix for the street (e.g., N, S, E, W).

      - `street_pre_direction: Optional[str]`

        The directional prefix for the street (e.g., N, S, E, W).

      - `street_type: Optional[str]`

        The type of street (e.g., St, Ave, Blvd).

      - `sub_administrative_area: Optional[str]`

        The sub-administrative area.

      - `sub_building: Optional[str]`

        The sub-building name or number (e.g., unit, suite).

      - `sub_building_floor: Optional[str]`

        The floor of the sub-building.

      - `sub_building_number: Optional[str]`

        The sub-building number.

      - `sub_building_type: Optional[str]`

        The type of sub-building (e.g., floor, wing).

      - `sub_street: Optional[str]`

        The sub-street name.

      - `sub_street_post_direction: Optional[str]`

        The directional suffix for the sub-street.

      - `sub_street_pre_direction: Optional[str]`

        The directional prefix for the sub-street.

      - `sub_street_type: Optional[str]`

        The type of sub-street.

      - `super_administrative_area: Optional[str]`

        The super-administrative area.

      - `telephone: Optional[str]`

        The telephone number associated with the address.

    - `errors: Optional[Errors]`

      Errors encountered during address verification.

      - `city: Optional[List[str]]`

        Errors related to the city.

      - `generic: Optional[List[str]]`

        Generic errors not tied to a specific field.

      - `line1: Optional[List[str]]`

        Errors related to the first address line.

      - `line2: Optional[List[str]]`

        Errors related to the second address line.

      - `postal_or_zip: Optional[List[str]]`

        Errors related to the postal or ZIP code.

      - `province_or_state: Optional[List[str]]`

        Errors related to the province or state.

    - `firm_name: Optional[str]`

      The firm or company name, if available.

    - `formatted_address: Optional[str]`

      The formatted address string.

    - `geo_data: Optional[DataGeoData]`

      Geocoding result for the verified address.

      - `geo_accuracy: Optional[str]`

        The geocode accuracy.

      - `latitude: Optional[str]`

        The latitude of the address.

      - `longitude: Optional[str]`

        The longitude of the address.

    - `line2: Optional[str]`

      The second address line.

    - `line3: Optional[str]`

      The third address line, if available.

    - `status: Optional[Status]`

      The verification status of an address.

      - `"verified"`

      - `"corrected"`

      - `"failed"`

    - `summary: Optional[DataSummary]`

      A summary of the verification process and match levels.

      - `context_identification_match_level: Optional[str]`

        Context identification match level.

      - `lexicon_identification_match_level: Optional[str]`

        Lexicon identification match level.

      - `match_score: Optional[float]`

        The match score (0-100).

      - `message: Optional[str]`

        Additional message about the verification.

      - `parsing_status: Optional[str]`

        The parsing status of the address.

      - `post_code_status: Optional[str]`

        The status of the postal code.

      - `post_processed_verification_match_level: Optional[str]`

        The match level after post-processing.

      - `pre_processed_verification_match_level: Optional[str]`

        The match level before post-processing.

      - `verification_status: Optional[str]`

        The overall verification status.

    - `zip_plus4: Optional[str]`

      The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Intl Address Verification Batch Verification Response

- `class IntlAddressVerificationBatchVerificationResponse: …`

  - `data: Data`

    - `results: List[DataResult]`

      - `error: Optional[str]`

        An error message for this address. Present when verification failed.

      - `verified_address: Optional[DataResultVerifiedAddress]`

        The result of a verified international address.

        - `city: str`

          The city or locality.

        - `country: str`

          The country code (ISO 3166-1 alpha-2).

        - `line1: str`

          The first address line.

        - `postal_or_zip: str`

          The postal or ZIP code.

        - `province_or_state: str`

          The province or state.

        - `country_name: Optional[str]`

          The full country name.

        - `details: Optional[DataResultVerifiedAddressDetails]`

          Additional details about the verified address, such as premise, thoroughfare, and locality.

          - `building: Optional[str]`

            The building name or number.

          - `building_type: Optional[str]`

            The type of building (e.g., apartment, office).

          - `city_name: Optional[str]`

            The full city name.

          - `city_secondary: Optional[str]`

            Secondary city information.

          - `city_type: Optional[str]`

            The type of city (e.g., city, town, village).

          - `delivery_address: Optional[str]`

            The full delivery address.

          - `dependent_locality: Optional[str]`

            The dependent locality (UK addresses).

          - `double_dependent_locality: Optional[str]`

            The double dependent locality (UK addresses).

          - `organization: Optional[str]`

            The organization or company name.

          - `postal_or_zip_primary: Optional[str]`

            The primary part of the postal or ZIP code.

          - `postal_or_zip_secondary: Optional[str]`

            The secondary part of the postal or ZIP code.

          - `post_box: Optional[str]`

            The post box number.

          - `premise: Optional[str]`

            The premise name or number.

          - `premise_number: Optional[str]`

            The premise number.

          - `premise_secondary: Optional[str]`

            Secondary premise information.

          - `premise_type: Optional[str]`

            The type of premise (e.g., house, flat).

          - `province_or_state_name: Optional[str]`

            The full name of the province or state.

          - `province_or_state_type: Optional[str]`

            The type of province or state (e.g., province, state, region).

          - `street: Optional[str]`

            The street name.

          - `street_post_direction: Optional[str]`

            The directional suffix for the street (e.g., N, S, E, W).

          - `street_pre_direction: Optional[str]`

            The directional prefix for the street (e.g., N, S, E, W).

          - `street_type: Optional[str]`

            The type of street (e.g., St, Ave, Blvd).

          - `sub_administrative_area: Optional[str]`

            The sub-administrative area.

          - `sub_building: Optional[str]`

            The sub-building name or number (e.g., unit, suite).

          - `sub_building_floor: Optional[str]`

            The floor of the sub-building.

          - `sub_building_number: Optional[str]`

            The sub-building number.

          - `sub_building_type: Optional[str]`

            The type of sub-building (e.g., floor, wing).

          - `sub_street: Optional[str]`

            The sub-street name.

          - `sub_street_post_direction: Optional[str]`

            The directional suffix for the sub-street.

          - `sub_street_pre_direction: Optional[str]`

            The directional prefix for the sub-street.

          - `sub_street_type: Optional[str]`

            The type of sub-street.

          - `super_administrative_area: Optional[str]`

            The super-administrative area.

          - `telephone: Optional[str]`

            The telephone number associated with the address.

        - `errors: Optional[Errors]`

          Errors encountered during address verification.

          - `city: Optional[List[str]]`

            Errors related to the city.

          - `generic: Optional[List[str]]`

            Generic errors not tied to a specific field.

          - `line1: Optional[List[str]]`

            Errors related to the first address line.

          - `line2: Optional[List[str]]`

            Errors related to the second address line.

          - `postal_or_zip: Optional[List[str]]`

            Errors related to the postal or ZIP code.

          - `province_or_state: Optional[List[str]]`

            Errors related to the province or state.

        - `firm_name: Optional[str]`

          The firm or company name, if available.

        - `formatted_address: Optional[str]`

          The formatted address string.

        - `geo_data: Optional[DataResultVerifiedAddressGeoData]`

          Geocoding result for the verified address.

          - `geo_accuracy: Optional[str]`

            The geocode accuracy.

          - `latitude: Optional[str]`

            The latitude of the address.

          - `longitude: Optional[str]`

            The longitude of the address.

        - `line2: Optional[str]`

          The second address line.

        - `line3: Optional[str]`

          The third address line, if available.

        - `status: Optional[Status]`

          The verification status of an address.

          - `"verified"`

          - `"corrected"`

          - `"failed"`

        - `summary: Optional[DataResultVerifiedAddressSummary]`

          A summary of the verification process and match levels.

          - `context_identification_match_level: Optional[str]`

            Context identification match level.

          - `lexicon_identification_match_level: Optional[str]`

            Lexicon identification match level.

          - `match_score: Optional[float]`

            The match score (0-100).

          - `message: Optional[str]`

            Additional message about the verification.

          - `parsing_status: Optional[str]`

            The parsing status of the address.

          - `post_code_status: Optional[str]`

            The status of the postal code.

          - `post_processed_verification_match_level: Optional[str]`

            The match level after post-processing.

          - `pre_processed_verification_match_level: Optional[str]`

            The match level before post-processing.

          - `verification_status: Optional[str]`

            The overall verification status.

        - `zip_plus4: Optional[str]`

          The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Intl Address Verification Get Autocomplete Previews Response

- `class IntlAddressVerificationGetAutocompletePreviewsResponse: …`

  - `data: List[Data]`

    - `id: Optional[str]`

      The unique identifier for this result. Pass this to `POST /completions`
      to retrieve the full address. If the `type` is `Container`, pass it as
      the `container` parameter to `GET /completions` to drill down further.

    - `description: Optional[str]`

      A secondary description of the result (e.g. city and country).

    - `error: Optional[str]`

      An error message if the lookup failed for this result.

    - `highlight: Optional[str]`

      Character ranges within `text` that match the search input, for bolding in UI.

    - `text: Optional[str]`

      The human-readable address suggestion text.

    - `type: Optional[str]`

      The type of result. `Address` means this can be resolved directly via
      `POST /completions`. `Container` means the result represents a building
      or complex — perform another `GET /completions` with this `id` as
      `container` to get individual unit addresses.

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Intl Address Verification Get Autocomplete Advanced Previews Response

- `class IntlAddressVerificationGetAutocompleteAdvancedPreviewsResponse: …`

  - `data: List[Data]`

    - `id: Optional[str]`

      The unique identifier for this result. Pass this to `POST /completions`
      to retrieve the full address. If the `type` is `Container`, pass it as
      the `container` parameter to `GET /completions` to drill down further.

    - `description: Optional[str]`

      A secondary description of the result (e.g. city and country).

    - `error: Optional[str]`

      An error message if the lookup failed for this result.

    - `highlight: Optional[str]`

      Character ranges within `text` that match the search input, for bolding in UI.

    - `text: Optional[str]`

      The human-readable address suggestion text.

    - `type: Optional[str]`

      The type of result. `Address` means this can be resolved directly via
      `POST /completions`. `Container` means the result represents a building
      or complex — perform another `GET /completions` with this `id` as
      `container` to get individual unit addresses.

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`

### Intl Address Verification Autocomplete Response

- `class IntlAddressVerificationAutocompleteResponse: …`

  - `data: Data`

    A fully resolved international address returned by `POST /completions`.

    - `class DataIntlAddressCompletion: …`

      A fully resolved international address returned by `POST /completions`.

      - `building: Optional[str]`

        The building name, if applicable.

      - `city: Optional[str]`

        The city or locality.

      - `company: Optional[str]`

        The company or organization name, if applicable.

      - `country: Optional[str]`

        The country name.

      - `country_code: Optional[str]`

        The ISO 2-letter country code.

      - `department: Optional[str]`

        The department or floor, if applicable.

      - `error: Optional[str]`

        An error message if resolution failed.

      - `formatted_address: Optional[str]`

        The full formatted address string.

      - `line1: Optional[str]`

        The first address line.

      - `line2: Optional[str]`

        The second address line.

      - `line3: Optional[str]`

        The third address line.

      - `line4: Optional[str]`

        The fourth address line.

      - `postal_or_zip: Optional[str]`

        The postal or ZIP code.

      - `province_code: Optional[str]`

        The province or state code.

      - `province_or_state: Optional[str]`

        The province or state name.

    - `class DataVerifiedAddress: …`

      The result of a verified international address.

      - `city: str`

        The city or locality.

      - `country: str`

        The country code (ISO 3166-1 alpha-2).

      - `line1: str`

        The first address line.

      - `postal_or_zip: str`

        The postal or ZIP code.

      - `province_or_state: str`

        The province or state.

      - `country_name: Optional[str]`

        The full country name.

      - `details: Optional[DataVerifiedAddressDetails]`

        Additional details about the verified address, such as premise, thoroughfare, and locality.

        - `building: Optional[str]`

          The building name or number.

        - `building_type: Optional[str]`

          The type of building (e.g., apartment, office).

        - `city_name: Optional[str]`

          The full city name.

        - `city_secondary: Optional[str]`

          Secondary city information.

        - `city_type: Optional[str]`

          The type of city (e.g., city, town, village).

        - `delivery_address: Optional[str]`

          The full delivery address.

        - `dependent_locality: Optional[str]`

          The dependent locality (UK addresses).

        - `double_dependent_locality: Optional[str]`

          The double dependent locality (UK addresses).

        - `organization: Optional[str]`

          The organization or company name.

        - `postal_or_zip_primary: Optional[str]`

          The primary part of the postal or ZIP code.

        - `postal_or_zip_secondary: Optional[str]`

          The secondary part of the postal or ZIP code.

        - `post_box: Optional[str]`

          The post box number.

        - `premise: Optional[str]`

          The premise name or number.

        - `premise_number: Optional[str]`

          The premise number.

        - `premise_secondary: Optional[str]`

          Secondary premise information.

        - `premise_type: Optional[str]`

          The type of premise (e.g., house, flat).

        - `province_or_state_name: Optional[str]`

          The full name of the province or state.

        - `province_or_state_type: Optional[str]`

          The type of province or state (e.g., province, state, region).

        - `street: Optional[str]`

          The street name.

        - `street_post_direction: Optional[str]`

          The directional suffix for the street (e.g., N, S, E, W).

        - `street_pre_direction: Optional[str]`

          The directional prefix for the street (e.g., N, S, E, W).

        - `street_type: Optional[str]`

          The type of street (e.g., St, Ave, Blvd).

        - `sub_administrative_area: Optional[str]`

          The sub-administrative area.

        - `sub_building: Optional[str]`

          The sub-building name or number (e.g., unit, suite).

        - `sub_building_floor: Optional[str]`

          The floor of the sub-building.

        - `sub_building_number: Optional[str]`

          The sub-building number.

        - `sub_building_type: Optional[str]`

          The type of sub-building (e.g., floor, wing).

        - `sub_street: Optional[str]`

          The sub-street name.

        - `sub_street_post_direction: Optional[str]`

          The directional suffix for the sub-street.

        - `sub_street_pre_direction: Optional[str]`

          The directional prefix for the sub-street.

        - `sub_street_type: Optional[str]`

          The type of sub-street.

        - `super_administrative_area: Optional[str]`

          The super-administrative area.

        - `telephone: Optional[str]`

          The telephone number associated with the address.

      - `errors: Optional[Errors]`

        Errors encountered during address verification.

        - `city: Optional[List[str]]`

          Errors related to the city.

        - `generic: Optional[List[str]]`

          Generic errors not tied to a specific field.

        - `line1: Optional[List[str]]`

          Errors related to the first address line.

        - `line2: Optional[List[str]]`

          Errors related to the second address line.

        - `postal_or_zip: Optional[List[str]]`

          Errors related to the postal or ZIP code.

        - `province_or_state: Optional[List[str]]`

          Errors related to the province or state.

      - `firm_name: Optional[str]`

        The firm or company name, if available.

      - `formatted_address: Optional[str]`

        The formatted address string.

      - `geo_data: Optional[DataVerifiedAddressGeoData]`

        Geocoding result for the verified address.

        - `geo_accuracy: Optional[str]`

          The geocode accuracy.

        - `latitude: Optional[str]`

          The latitude of the address.

        - `longitude: Optional[str]`

          The longitude of the address.

      - `line2: Optional[str]`

        The second address line.

      - `line3: Optional[str]`

        The third address line, if available.

      - `status: Optional[Status]`

        The verification status of an address.

        - `"verified"`

        - `"corrected"`

        - `"failed"`

      - `summary: Optional[DataVerifiedAddressSummary]`

        A summary of the verification process and match levels.

        - `context_identification_match_level: Optional[str]`

          Context identification match level.

        - `lexicon_identification_match_level: Optional[str]`

          Lexicon identification match level.

        - `match_score: Optional[float]`

          The match score (0-100).

        - `message: Optional[str]`

          Additional message about the verification.

        - `parsing_status: Optional[str]`

          The parsing status of the address.

        - `post_code_status: Optional[str]`

          The status of the postal code.

        - `post_processed_verification_match_level: Optional[str]`

          The match level after post-processing.

        - `pre_processed_verification_match_level: Optional[str]`

          The match level before post-processing.

        - `verification_status: Optional[str]`

          The overall verification status.

      - `zip_plus4: Optional[str]`

        The ZIP+4 code (for US addresses).

  - `message: str`

  - `status: Literal["success", "error"]`

    - `"success"`

    - `"error"`