---
title: "Record a transaction"
method: POST
path: "/v1/transactions"
tags: ["Nexus"]
---

# Record a transaction

`POST /v1/transactions`

## Request

- Base URL: `https://api.taxlocus.com`
- URL: `https://api.taxlocus.com/v1/transactions`
- Auth: HTTP bearer

Append a sale to a tracked entity's ledger and return updated nexus status. Supports idempotency via `idempotency_key`.

## Request body

- object
  - `entity_id` string, uuid, required
  - `state` string, required
  - `sale_amount` number, required
  - `transaction_date` string, date
  - `is_marketplace` boolean
  - `is_exempt` boolean
  - `external_ref` string
  - `idempotency_key` string
  - `county_fips` string
  - `place_geoid` string
  - `tax_collected` number
  - `lat` number
  - `lng` number
  - `address` object
    - `line1` string, required
    - `city` string, required
    - `state` string, required
    - `postal_code` string, required

## Response `200`

Updated nexus status for the entity.

- object

## Other responses

- `400`: Error response.
- `401`: Error response.
- `429`: Error response.
- `500`: Error response.

---

[API](https://skmtc.dev/taxlocus/apis/taxlocus-rest-api.md) · [All operations](https://skmtc.dev/taxlocus/apis/taxlocus-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taxlocus/apis/taxlocus-rest-api/revisions/f3d4b84bdc56?raw)