---
title: PhysicalAddress type | Wartiva GraphQL API
description: A physical address. Wartiva GraphQL API reference with arguments, fields, and examples. Browse related operations and types.
url: https://wartiva.com/api-docs/types/physical-address.html
updated: 2026-10-07
---

Location · GraphQL type

# `PhysicalAddress` type

A physical address.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`PlusCodeGlobalCode!`](https://wartiva.com/api-docs/types/plus-code-global-code.html) | Unique id of the physical address if available in open location code format, also known as a global plus code. |
| `addressComponents` - [`[PhysicalAddressComponent!]`](https://wartiva.com/api-docs/types/physical-address-component.html) | An array containing the separate components applicable to this address. |
| `street` - [`String`](https://wartiva.com/api-docs/types/string.html) | The street name or route parsed from the components for convenience if available. |
| `streetNumber` - [`String`](https://wartiva.com/api-docs/types/string.html) | Street number parsed from the components for convenience if available. |
| `neighborhood` - [`String`](https://wartiva.com/api-docs/types/string.html) | A named neighborhood parsed from the components for convenience if available. |
| `district` - [`String`](https://wartiva.com/api-docs/types/string.html) | The district or sub-locality parsed from the components for convenience if available. |
| `city` - [`String`](https://wartiva.com/api-docs/types/string.html) | City parsed from the components for convenience if available. |
| `county` - [`String`](https://wartiva.com/api-docs/types/string.html) | County parsed from the components for convenience if USA and available. |
| `state` - [`String`](https://wartiva.com/api-docs/types/string.html) | State parsed from the components for convenience if USA and available. |
| `stateCode` - [`String`](https://wartiva.com/api-docs/types/string.html) | Two letter state code parsed from the components for convenience if USA and available. |
| `province` - [`String`](https://wartiva.com/api-docs/types/string.html) | Province parsed from the components for convenience if Canada and available. |
| `provinceCode` - [`String`](https://wartiva.com/api-docs/types/string.html) | Two letter province code parsed from the components for convenience if Canada and available. |
| `country` - [`String`](https://wartiva.com/api-docs/types/string.html) | Country parsed from the components for convenience if available. |
| `countryCode` - [`String`](https://wartiva.com/api-docs/types/string.html) | Two letter ISO 3166 country code parsed form the components for convenience if available. See [ISO 3166-2 country codes (Wikipedia)](https://en.wikipedia.org/wiki/ISO_3166-2) |
| `postalCode` - [`String`](https://wartiva.com/api-docs/types/string.html) | Postal code parsed from the components for convenience if available. |
| `formattedAddress` - [`String`](https://wartiva.com/api-docs/types/string.html) | Full formatted address parsed from the components for convenience if available. |
| `shortAddress` - [`String`](https://wartiva.com/api-docs/types/string.html) | A convenient short format address if available e.g.: Austin, TX USA |

## Used by

- [`Location`](https://wartiva.com/api-docs/types/location.html) type: A physical place identified by its global plus code (Open Location Code), with a street address resolved by reverse geocoding.

## Example

### Example

```json
{
  "id": "796RWF8Q+WF",
  "addressComponents": [PhysicalAddressComponent],
  "street": "xyz789",
  "streetNumber": "abc123",
  "neighborhood": "abc123",
  "district": "abc123",
  "city": "abc123",
  "county": "xyz789",
  "state": "xyz789",
  "stateCode": "abc123",
  "province": "xyz789",
  "provinceCode": "abc123",
  "country": "xyz789",
  "countryCode": "abc123",
  "postalCode": "abc123",
  "formattedAddress": "abc123",
  "shortAddress": "xyz789"
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt