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

GETPOST/api/v1/accounting/invoices.taxPlace

Permissions

accounting:read

Who can call it

admin, finance

Retries

Safe to retry: it only reads

MCP

accounting_invoices_tax_place

Reaches outside Oatmilk

It emails people or calls another service.

Fields

partyIdstring (ID)
The ID of a customer or vendor account, from parties.list.
querystring
Text to search for.
2–120 characters

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'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/invoices.taxPlace?partyId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/invoices.taxPlace",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "partyId": "7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Response

{
  "data": { … }
}

Try it

Checks your input with this action’s real schema and answers like the API, with synthetic data. No key needed, and nothing changes.

Input

GET/api/v1/accounting/invoices.taxPlace

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'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/invoices.taxPlace?partyId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/invoices.taxPlace",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "partyId": "7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Fields

Example

Try it