List SAML IdPs
The endpoint's SAML identity providers (IdPs), one sign-in button each, with their certificates, who can join through them, their group rules and how many users sign in with each. Reading needs no plan, so an account whose plan no longer includes SAML still sees, turns off and removes its IdPs. In the dashboard: the IdP rows under Single sign-on in Sign-in & access › Sign-in.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Response (200 OK)
endpoint_uuid string (uuid)
The endpoint.
max_idps integer
How many IdPs an endpoint can have:
20.idps array<object>
Each IdP, as Get SAML IdP answers it. Empty when there are none.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Caller lacks the
endpoints:read permission in the active account.404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/saml/idps" \
-H "X-API-KEY: <your_api_key>"
CLI
ngris api saml-idps list 019bb1e4-e785-77d2-9966-c3cff31d0a0e
Response
{
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"max_idps": 20,
"idps": [
{
"uuid": "019c6a2e-4b10-7c3d-9e21-5a7f0b8c1d23",
"name": "Acme SSO",
"enabled": true,
"entity_id": "https://idp.example.com/saml",
"join_mode": "anyone",
"linked_users": 12,
"last_error": "not_signed",
"last_error_at": "2026-11-14T08:55:02Z",
…
}
]
}
Was this helpful?