## Resolve Tax Addresses

Stripe Tax calculates tax rates based on customer addresses, but some addresses don’t contain enough detail to determine an exact rate. For example, a US postal code can span multiple tax jurisdictions, so Stripe Tax could approximate the rate rather than calculate the exact rate for that address.

Use the Address Resolution API to check how precisely Stripe Tax can determine the tax rate for a given address before using it in a tax calculation. The API returns:

*   The precision level at which Stripe Tax can determine the tax rate for the address
*   The address fields to collect or update so Stripe Tax can determine a more precise tax rate

### Before you begin

Set up Stripe Tax and configure your tax settings.

### Resolve an address

**Request**

```
POST /v2/tax/address_resolution
```

```json
{
  "address": {
    "country": "US",
    "state": "CA",
    "city": "South San Francisco",
    "postal_code": "94080",
    "line1": "354 Oyster Point Blvd"
  }
}
```

**Response**

```json
{
  "object": "v2.tax.address_resolution",
  "livemode": false,
  "precision": "address",
  "precision_details": {
    "issues": []
  },
  "address": {
    "country": "US",
    "state": "CA",
    "city": "South San Francisco",
    "postal_code": "94080",
    "line1": "354 Oyster Point Blvd"
  }
}
```

### Understand precision levels

The `precision` field tells you at what level of detail Stripe Tax can determine the tax rate when calculating tax for the address.

| Precision   | Description                                                                 |
| :---------- | :-------------------------------------------------------------------------- |
| `zip_code`  | Stripe Tax can determine the tax rate at the zip code level.                |
| `city`      | Stripe Tax can determine the tax rate at the city level.                    |
| `state`     | Stripe Tax can determine the tax rate at the state level.                   |
| `country`   | Stripe Tax can determine the tax rate at the country level.                 |
| `address`   | Stripe Tax can determine the tax rate at the street address level.          |
| `ambiguous` | Stripe Tax cannot determine the tax rate for the address.                   |
| `invalid`   | The address is invalid.                                                     |

The `precision_details.issues` field provides more information about why the address may not be precise enough for tax calculation.