Auth
Look Up SSO Identity Provider
Resolve an email's domain to its organisation's SSO identity provider, if any. Unauthenticated by design - called from the login page before any credentials are presented. An unknown domain, an unverified domain, and a disabled SSO config all return the same empty result, so the response never reveals which case applies.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for the IdP lookup endpoint - just the candidate email address.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/auth/idp-lookup" \ -H "Content-Type: application/json" \ -d '{ "email": "string" }'{ "idp_alias": "string", "org_id": "string", "org_name": "string", "require_sso": false}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string" } ]}