---
title: "Pause a connection"
method: POST
path: "/fiscal-document/v1/fiscalization/connections/{connectionId}/pause"
tags: ["Fiscal Connection Config"]
---

# Pause a connection

`POST /fiscal-document/v1/fiscalization/connections/{connectionId}/pause`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscalization/connections/{connectionId}/pause`
- 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: `write:reservation`

## Path parameters

- `connectionId` integer, required

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- FiscalConnection
  - `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

## Other responses

- `404`: Not found

---

[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)