CLcloudbeds
Fiscal Connection Config

Get certificate status for a connection

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.

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
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
      Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: read:reservation

Path parameters

connectionIdinteger required

Headers

X-Property-IDinteger required

Property id

Response

Certificate metadata retrieved successfully

verifiedboolean

Whether the certificate has been verified by the provider

createdAtstring date-time required

When the certificate was first uploaded

updatedAtstring date-time required

When the certificate was last updated

expiresAtstring date-time nullable

Certificate notAfter date parsed from the uploaded X.509 certificate. Null when not applicable or not yet parsed.

providerValidboolean nullable

Live provider validity — true when the provider reports the certificate as valid and accepted. Null when the provider check was skipped or unavailable.

invalidReasonstring nullable

Provider-reported reason for invalidity (e.g. HR_1002). Only present when providerValid is false.

Changes

No recorded changes to this operation across all 1 revision of this API.