# invoices.taxPlace

Work out where a customer is for sales tax. With query, the places a typed city, town, province, postal code or country can mean (Toronto, Gimli MB, M5V 2T6, London UK), each with its jurisdiction such as CA-ON; a name Oatmilk doesn't know is read by AI that has no tools and never picks the tax. With partyId, a web search for the customer's head office by its name and website, returning the place only when a quote on the page it came from says it, with that page and quote. Only the name, the website or billing email's domain, and the city leave Oatmilk. Nothing is saved; set the customer's address or the invoice's tax to use the place.

`GET | POST /api/v1/accounting/invoices.taxPlace`

Permissions: `accounting:read` · Roles: admin, finance · Reaches outside Oatmilk (email or a provider)

MCP tool: `accounting_invoices_tax_place`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `partyId` | string (ID) |  | The ID of a customer or vendor account, from parties.list. |
| `query` | string |  | Text to search for. 2–120 characters. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/invoices.taxPlace \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'partyId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10'
```

Reference page: https://app.getoatmilk.com/docs/api/invoices.taxPlace