Get OAuth Provider

GET /v1/endpoints/{endpoint_id}/oauth/providers/{provider_id}

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

endpoint_id string (uuid) Req
Endpoint UUID.
provider_id int64 Req
Numeric provider ID. Get from /oauth/providers.

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.

Errors

400 Bad Request
Non-numeric provider_id.
401 Unauthorized
Missing auth.
404 Not Found
Endpoint or provider doesn't exist (or doesn't belong to the calling user). Provider must belong to the named endpoint.
Request
curl "https://api.ngris.com/v1/endpoints/<uuid>/oauth/providers/1" \ -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>", "1") print(p["provider_type"], p["client_id"])
Response — 200 OK
{ "id": 1, "endpoint_id": 184, "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, "created_at": "2026-04-01T00:00:00Z", "updated_at": "2026-04-01T00:00:00Z" }
On this page
Get OAuth Provider
Iris