---
title: "List connections for a property"
method: GET
path: "/fiscal-document/v1/fiscalization/connections"
tags: ["Fiscal Connection Config"]
---

# List connections for a property

`GET /fiscal-document/v1/fiscalization/connections`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscalization/connections`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
    - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `read:reservation`

## Query parameters

- `drafts` boolean

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- FiscalConnectionListResponse
  - `connections` FiscalConnection[], required
    - `id` integer, required
    - `status` 'verifying' | 'active' | 'attention' | 'error' | 'paused', required
    - `detail` string
    - `label` string
    - `taxId` string
    - `connectedAt` string, date-time, required
    - `pausedAt` string, date-time
    - `authorization` FiscalConnectionAuthorization: Browser redirect for partner consent, present only for OAuth-handoff providers. The url is relative to the property's MFD origin — the FE prefixes window.location.origin before redirecting.
      - `url` string, required
      - `expiresAt` string, date-time, required
    - `provider` object, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `visual` FiscalProviderVisual
        - `bg` string
        - `fg` string
        - `code` string
    - `channel` object, required
      - `country` string, required
      - `code` string, required
      - `name` string
      - `flows` FiscalChannelFlow[]
        - `id` string, required
        - `name` string, required
        - `subtitle` string
        - `inherits` string
    - `onboarding` object: Onboarding progress. Present when the connection has required setup steps.
      - `completed` string[]
      - `total` integer
      - `current` object
        - `key` string
        - `label` string
      - `progress` string: e.g. Paused at "Certificate" · Step 2 of 3
      - `done` boolean
      - `failed` object: Present when the connection is in ERROR and a specific step caused the failure.
        - `key` string
        - `label` string
        - `error` string
  - `drafts` FiscalConnectionDraft[]
    - `providerId` string, required
    - `data` object
    - `currentStep` integer: Zero-based index of the step the user was on when they saved.
    - `updatedAt` string, date-time, required

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)