Retrieves all tax groups for an application, including their associated markets and country-specific tax percentages.

API ownership

• API family: Management API
• Best for: Trusted back-office workflows that create, update, organize, or delete merchant-owned data.
• Do not use from: Browser-only storefront code or public clients.
• Guide route: /apis/management/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: GET
• Path: /api/v1/\{team_slug\}/\{app_slug\}/tax-groups
• Summary: List all tax groups
• Description: Retrieves all tax groups for an application, including their associated markets and country-specific tax percentages.
• OpenAPI contract: management-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "data": [
    {
      "created_at": "string",
      "description": "string",
      "id": "string",
      "is_default": false,
      "markets": [
        {
          "active": null,
          "country_codes": null,
          "country_tax_percentages": null,
          "created_at": null,
          "currency_code": null,
          "id": null,
          "locale": null,
          "name": null,
          "slug": null,
          "updated_at": null
        }
      ],
      "name": "string",
      "slug": "string",
      "updated_at": "string"
    }
  ],
  "success": false,
  "total": 0,
  "total_pages": 0
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Management API
• Method: GET
• Path: /api/v1/\{team_slug\}/\{app_slug\}/tax-groups
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: TaxGroups
• OpenAPI summary: List all tax groups