## Parse An Address

**post** `/v1/addver/parses`

Parses a freeform address string into its individual components
(house number, street name, city, state, postal code, etc.).

Useful for extracting structured data from a single-line address without
running a full verification.

- Uses 1 lookup.

### Body Parameters

- `address: string`

  The address you want to verify, written on a single line.

### Returns

- `data: object { category, city, cityDistrict, 13 more }`

  - `category: optional string`

    The category of the location (e.g. restaurant).

  - `city: optional string`

    The city name.

  - `cityDistrict: optional string`

    The borough within a city.

  - `country: optional string`

    The country.

  - `house: optional string`

    The name of the location.

  - `houseNumber: optional string`

    The house or street number.

  - `island: optional string`

    The name of the island.

  - `level: optional string`

    The floor.

  - `near: optional string`

    Populated if the input query contains a near/in qualifier.

  - `poBox: optional string`

    The postal office box.

  - `postcode: optional string`

    The postal or ZIP code.

  - `road: optional string`

    The street name.

  - `state: optional string`

    The state or province.

  - `stateDistrict: optional string`

    The county.

  - `suburb: optional string`

    The unofficial neighborhood name.

  - `unit: optional string`

    The apartment, unit, office, lot, or other secondary unit designator.

- `message: string`

- `status: "success" or "error"`

  - `"success"`

  - `"error"`

### Example

```http
curl https://api.postgrid.com/v1/addver/parses \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $POSTGRID_ADDRESS_VERIFICATION_API_KEY" \
    -d '{
          "address": "address"
        }'
```

#### Response

```json
{
  "data": {
    "category": "category",
    "city": "city",
    "cityDistrict": "cityDistrict",
    "country": "country",
    "house": "house",
    "houseNumber": "houseNumber",
    "island": "island",
    "level": "level",
    "near": "near",
    "poBox": "poBox",
    "postcode": "postcode",
    "road": "road",
    "state": "state",
    "stateDistrict": "stateDistrict",
    "suburb": "suburb",
    "unit": "unit"
  },
  "message": "message",
  "status": "success"
}
```