---
title: "dimensions.list"
method: POST
path: "/capabilities/dimensions.list"
tags: ["Capabilities"]
---

# dimensions.list

`POST /capabilities/dimensions.list`

## Request

- Base URL: `https://developer.api.receiptor.ai/v1`
- URL: `https://developer.api.receiptor.ai/v1/capabilities/dimensions.list`
- Auth: one of:
  - API key in header `x-receiptor-api-key`
  - HTTP bearer

List Xero tracking categories and options for enabled accounting connections. connections reports connected and trackingEnabled for each matching Xero organisation. If trackingEnabled is false, explain that tracking categories are disabled in Receiptor. Do not interpret disabled tracking as zero categories in Xero. If connected is false, explain that the organisation needs reconnecting. Use exact returned dimensionId (_id) and valueId (values.id) when saving a tracking memory. Vocabulary is read-only.

## Request body

- object
  - `integrationId` string
  - `connectionId` string
  - `refresh` boolean

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object: Capability-specific result

## Other responses

- `400`: Invalid input
- `401`: Authentication required
- `404`: Resource not found

## Changes

- **2026-10-21** `b0fefd7d16a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/receiptor/apis/receiptor-ai-api/changes/capabilities/dimensions.list/post.md)

---

[API](https://skmtc.dev/receiptor/apis/receiptor-ai-api.md) - [All operations](https://skmtc.dev/receiptor/apis/receiptor-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/receiptor/apis/receiptor-ai-api/revisions/a2d8aea5337a?raw)