> This page is for Unified.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

The `TaxRate` object is used to represent a tax rate.

### The TaxRate Object

```json
{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "company": "string",
  "code": "string",
  "name": "string",
  "description": "string",
  "status": "ACTIVE",
  "country": "string",
  "total_tax_rate": 1,
  "effective_tax_rate": 1,
  "tax_components": [
    {
      "id": "string",
      "remote_id": "string",
      "created_at": "2023-01-01T00:00:00Z",
      "modified_at": "2023-01-01T00:00:00Z",
      "name": "string",
      "rate": "string",
      "is_compound": true,
      "component_type": "SALES",
      "remote_was_deleted": true
    }
  ],
  "remote_was_deleted": true,
  "field_mappings": {
    "organization_defined_targets": {
      "string": {}
    },
    "linked_account_defined_targets": {
      "string": {}
    }
  },
  "remote_data": [
    {
      "path": "string",
      "data": {}
    }
  ]
}
```

### Schema (`TaxRate`)

```yaml
components:
  schemas:
    Status7d1Enum:
      type: string
      enum:
        - ACTIVE
        - ARCHIVED
      title: Status7d1Enum
    ComponentTypeEnum:
      type: string
      enum:
        - SALES
        - PURCHASE
      title: ComponentTypeEnum
    TaxComponent:
      type: object
      properties:
        id:
          type: string
          format: uuid
        remote_id:
          type:
            - string
            - 'null'
          description: The third-party API ID of the matching object.
        created_at:
          type: string
          format: date-time
          description: The datetime that this object was created by Merge.
        modified_at:
          type: string
          format: date-time
          description: The datetime that this object was modified by Merge.
        name:
          type:
            - string
            - 'null'
          maxLength: 100
          description: The tax rate’s name.
        rate:
          type:
            - string
            - 'null'
          format: decimal
          pattern: ^-?\d{0,32}(?:\.\d{0,16})?$
          description: The tax component’s rate.
        is_compound:
          type:
            - boolean
            - 'null'
          description: Returns True if the tax component is compound, False if not.
        component_type:
          oneOf:
            - $ref: '#/components/schemas/ComponentTypeEnum'
            - type: 'null'
          description: >-
            Returns PURCHASE if the tax component corresponds to a purchase tax
            or SALES if the tax component corresponds to a sales tax.
        remote_was_deleted:
          type: boolean
          description: >-
            Indicates whether or not this object has been deleted in the third
            party platform. Full coverage deletion detection is a premium
            add-on. Native deletion detection is offered for free with limited
            coverage. [Learn
            more](https://docs.merge.dev/integrations/hris/supported-features/).
      description: >-
        # The TaxRate Object

        ### Description

        The `TaxComponent` object is used to represent any sub-taxes that make
        up the `TaxRate`.


        ### Usage Example

        Fetch from the `LIST TaxRates` endpoint and view tax components relevant
        to a tax rate.
      title: TaxComponent
    TaxRateFieldMappings:
      type: object
      properties:
        organization_defined_targets:
          type: object
          additionalProperties:
            description: Any type
        linked_account_defined_targets:
          type: object
          additionalProperties:
            description: Any type
      title: TaxRateFieldMappings
    RemoteData:
      type: object
      properties:
        path:
          type: string
          description: The third-party API path that is being called.
        data:
          description: >-
            The data returned from the third-party for this object in its
            original, unnormalized format.
      required:
        - path
      description: >-
        # The RemoteData Object

        ### Description

        The `RemoteData` object is used to represent the full data pulled from
        the third-party API for an object.


        ### Usage Example

        TODO
      title: RemoteData
    TaxRate:
      type: object
      properties:
        id:
          type: string
          format: uuid
        remote_id:
          type:
            - string
            - 'null'
          description: The third-party API ID of the matching object.
        created_at:
          type: string
          format: date-time
          description: The datetime that this object was created by Merge.
        modified_at:
          type: string
          format: date-time
          description: The datetime that this object was modified by Merge.
        company:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            The subsidiary that the tax rate belongs to (in the case of
            multi-entity systems).
        code:
          type:
            - string
            - 'null'
          maxLength: 100
          description: >-
            The tax code associated with this tax rate or group of tax rates
            from the third-party platform.
        name:
          type:
            - string
            - 'null'
          maxLength: 100
          description: The tax rate’s name.
        description:
          type:
            - string
            - 'null'
          description: The tax rate's description.
        status:
          oneOf:
            - $ref: '#/components/schemas/Status7d1Enum'
            - type: 'null'
          description: >-
            The tax rate’s status - `ACTIVE` if an active tax rate, `ARCHIVED`
            if not active.
        country:
          type:
            - string
            - 'null'
          maxLength: 100
          description: The country the tax rate is associated with.
        total_tax_rate:
          type:
            - number
            - 'null'
          format: double
          description: >-
            The tax’s total tax rate - sum of the tax components (not
            compounded).
        effective_tax_rate:
          type:
            - number
            - 'null'
          format: double
          description: >-
            The tax rate’s effective tax rate - total amount of tax with
            compounding.
        tax_components:
          type: array
          items:
            $ref: '#/components/schemas/TaxComponent'
          description: The related tax components of the tax rate.
        remote_was_deleted:
          type: boolean
          description: >-
            Indicates whether or not this object has been deleted in the third
            party platform. Full coverage deletion detection is a premium
            add-on. Native deletion detection is offered for free with limited
            coverage. [Learn
            more](https://docs.merge.dev/integrations/hris/supported-features/).
        field_mappings:
          oneOf:
            - $ref: '#/components/schemas/TaxRateFieldMappings'
            - type: 'null'
        remote_data:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/RemoteData'
      title: TaxRate
```