---
title: "POST /v1/addver/parses"
method: POST
path: "/v1/addver/parses"
tags: ["Standard API"]
---

# POST /v1/addver/parses

`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.

## Request body

- StandardFreeformAddressInput
  - `address` string, required — The address you want to verify, written on a single line.

## Response `200`

The request has succeeded.

- object
  - `status` 'success' | 'error', required
  - `message` string, required
  - `data` ParsedAddress, required
    - `house` string — The name of the location.
    - `category` string — The category of the location (e.g. restaurant).
    - `near` string — Populated if the input query contains a near/in qualifier.
    - `houseNumber` string — The house or street number.
    - `road` string — The street name.
    - `unit` string — The apartment, unit, office, lot, or other secondary unit designator.
    - `level` string — The floor.
    - `poBox` string — The postal office box.
    - `postcode` string — The postal or ZIP code.
    - `suburb` string — The unofficial neighborhood name.
    - `cityDistrict` string — The borough within a city.
    - `city` string — The city name.
    - `island` string — The name of the island.
    - `stateDistrict` string — The county.
    - `state` string — The state or province.
    - `country` string — The country.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `403` — Access is forbidden.

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/versions/537d2bbc624a/schema)