---
title: "Get certificate status for a connection"
method: GET
path: "/fiscal-document/v1/fiscalization/connections/{connectionId}/certificate"
tags: ["Fiscal Connection Config"]
---

# Get certificate status for a connection

`GET /fiscal-document/v1/fiscalization/connections/{connectionId}/certificate`

## Request

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

Returns metadata about the stored fiscalization certificate for the given connection,
including expiry date and live provider validity. Returns 404 if no certificate has
been uploaded for this connection or if the provider does not require a certificate.
The provider validity check is best-effort: on provider unavailability the stored
status is returned without failing the request.

## Path parameters

- `connectionId` integer, required

## Headers

- `X-Property-ID` integer, required

## Response `200`

Certificate metadata retrieved successfully

- FiscalizationCertificateStatus
  - `verified` boolean: Whether the certificate has been verified by the provider
  - `createdAt` string, date-time, required: When the certificate was first uploaded
  - `updatedAt` string, date-time, required: When the certificate was last updated
  - `expiresAt` string, date-time, nullable: Certificate notAfter date parsed from the uploaded X.509 certificate. Null when not applicable or not yet parsed.
  - `providerValid` boolean, nullable: Live provider validity — true when the provider reports the certificate as valid and accepted. Null when the provider check was skipped or unavailable.
  - `invalidReason` string, nullable: Provider-reported reason for invalidity (e.g. HR_1002). Only present when providerValid is false.

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