# Ziptastic

> Turn a US ZIP code into the city and state it belongs to, to fill in the rest of an address or check what someone typed into a form. Covers every state, Washington DC, the territories and military addresses. No account or API key required.

App · 1 action. Web page: https://docs.lodol.com/docs/integrations/ziptastic

## Actions

### Look up ZIP code

Find the city and state a US ZIP code belongs to, for filling in the rest of an address or checking what someone typed into a form. Territories and military addresses are covered too. A ZIP code Ziptastic does not know comes back with 'found' set to false rather than failing the step. No API key required.

**Inputs**

- ZIP code (`zip_code`, text, required): A five-digit US ZIP code. ZIP+4 such as 48867-1234 is fine: only the first five digits are looked up.

**Outputs**

- `city` (text): The city or town, in normal capitalisation, e.g. 'Owosso'.
- `city_as_listed` (text): The city exactly as Ziptastic lists it, in capitals, e.g. 'OWOSSO'.
- `country` (text): The country's two-letter code: always 'US' for a ZIP code found.
- `found` (true/false): True when Ziptastic knows this ZIP code. False means it has no record of it, and the place fields are empty.
- `state` (text): The state's two-letter USPS abbreviation, e.g. 'MI'.
- `state_name` (text): The state, territory or military region written out, e.g. 'Michigan', 'Puerto Rico' or 'Armed Forces Europe'.
- `summary` (text): One line naming the place, e.g. 'Owosso, MI 48867', or saying that no place was found.
- `zip_code` (text): The five-digit ZIP code that was looked up, e.g. '48867'.

**Example output**

```json
{
  "city": "Owosso",
  "city_as_listed": "OWOSSO",
  "country": "US",
  "found": true,
  "state": "MI",
  "state_name": "Michigan",
  "summary": "Owosso, MI 48867",
  "zip_code": "48867"
}
```