Get OAuth Provider

GET /v1/endpoints/{uuid}/oauth/providers/{provider_uuid}

Read full configuration of one OAuth provider attached to an endpoint. Same shape as a single entry from the list endpoint.

Client secret is never returned — it's encrypted at rest and only used internally for the OAuth code-exchange flow. To rotate, call update with a fresh client_secret.

Path parameters

uuid string (uuid) Req
The endpoint's uuid.
provider_uuid string (uuid) Req
The provider's uuid. Get it from /oauth/providers. It resolves only under the endpoint in the path.

Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.

Response (200 OK)

The single provider object (not wrapped in a providers envelope). Same field set as one entry from /oauth/providers. scopes is comma-separated; client_secret is never included — has_client_secret says whether one is stored.

Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.

Errors

400 Bad Request
An integer provider id after the sunset (integer_id_unsupported).
401 Unauthorized
Missing auth.
404 Not Found
Endpoint not found or Provider not found — the endpoint isn't in your active account, or the provider isn't on that endpoint (another endpoint's provider reads like an unknown one).
Request
curl "https://api.ngris.com/v1/endpoints/<uuid>/oauth/providers/019b407c-8a46-7001-897f-343e36ba8939" \ -H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") p = client.endpoint_oauth.get_provider("<endpoint_uuid>", "019b407c-8a46-7001-897f-343e36ba8939") print(p["provider_type"], p["client_id"])
Response — 200 OK
{ "uuid": "019b407c-8a46-7001-897f-343e36ba8939", "endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e", "provider_type": "google", "provider_name": "Sign in with Google", "client_id": "1234567890-abc.apps.googleusercontent.com", "auth_url": "https://accounts.google.com/o/oauth2/v2/auth", "token_url": "https://oauth2.googleapis.com/token", "user_info_url": "https://www.googleapis.com/oauth2/v2/userinfo", "scopes": "openid,email,profile", "identifier_field": "email", "enabled": true, "has_client_secret": true, "created_at": "2026-04-01T00:00:00Z", "updated_at": "2026-04-01T00:00:00Z" }
Was this helpful?
On this page
Get OAuth Provider
Was this helpful?