# accountant.tax.request

Accountants only: ask the company to collect or confirm missing tax details for one contractor and calendar year. The request contains missing field names only, never tax number values, and goes to the company question queue.

`POST /api/v1/accounting/accountant.tax.request`

Permissions: `accounting:read` · Roles:  · Idempotency key required

MCP tool: `accounting_accountant_tax_request`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `contractorId` | string (ID) | Yes | The ID of a contractor, from contractors.list. |
| `calendarYear` | integer | Yes | A calendar year, such as 2026. 2000 to 2100. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/accountant.tax.request \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "contractorId": "4d5e6f7a-8b9c-4d0e-8f1a-2b3c4d5e6f7a",
  "calendarYear": 2026
}'
```

Reference page: https://app.getoatmilk.com/docs/api/accountant.tax.request