Skip to main content
Version: Latest (3.102.6)

Public Page Information (Get Public Request ID)

GET 
/public-srv/public/:requestId

This API retrieves the configuration and details for a specific authentication or verification request. It is primarily used by hosted pages (Login, Registration, Password Reset) to render the UI according to the application's settings.

A successful response uses the standard envelope: success, status, and data (see the response schema). Error responses use the same flat shape as other public cidaas APIs: success, status, code, and error (message). For this operation, 400 with PUB10001 indicates an invalid requestId format (not a UUID); 400 with PUB10002 indicates app details could not be resolved for the request id (for example expired or unknown request). Those cases are not 500 errors.

Path parameter requestId, header Accept-Language, and error examples are documented under this operation.

1. Description​

The Public Page Information API is called by the front-end application at the beginning of an authentication or verification flow. It provides all the necessary context, such as allowed login methods, multi-factor authentication (MFA) requirements, branding (colors, logos), and password policies.

When to call this API

  • When a user lands on a default-hosted-pages-webapp login or registration page.
  • When a verification flow (e.g., email verification, MFA challenge) is initiated.
  • To retrieve the visual theme (colors, logos, media) for a specific client application.

Request​

Responses​

Success