## OAuth Client Details `client.IAM.OAuthClients.Get(ctx, oauthClientID, query) (*OAuthClientGetResponse, error)` **get** `/accounts/{account_id}/oauth_clients/{oauth_client_id}` Get details of a specific OAuth client. ### Parameters - `oauthClientID string` The unique identifier for an OAuth client. - `query OAuthClientGetParams` - `AccountID param.Field[string]` Account identifier tag. ### Returns - `type OAuthClientGetResponse struct{…}` Fields shared by OAuth client responses and create/update requests. - `ClientID string` The unique identifier for an OAuth client. - `Visibility OAuthClientGetResponseVisibility` Visibility of the OAuth client. - `const OAuthClientGetResponseVisibilityPublic OAuthClientGetResponseVisibility = "public"` - `const OAuthClientGetResponseVisibilityPrivate OAuthClientGetResponseVisibility = "private"` - `AllowedCORSOrigins []string` Array of allowed CORS origins. - `ClientName string` Human-readable name of the OAuth client. - `ClientURI string` URL of the home page of the client. - `ClientURIVerification OAuthClientGetResponseClientURIVerification` Client URI domain control verification state. - `Status OAuthClientGetResponseClientURIVerificationStatus` Current verification status for the client URI host. - `const OAuthClientGetResponseClientURIVerificationStatusPending OAuthClientGetResponseClientURIVerificationStatus = "pending"` - `const OAuthClientGetResponseClientURIVerificationStatusInProgress OAuthClientGetResponseClientURIVerificationStatus = "in_progress"` - `const OAuthClientGetResponseClientURIVerificationStatusVerified OAuthClientGetResponseClientURIVerificationStatus = "verified"` - `const OAuthClientGetResponseClientURIVerificationStatusFailed OAuthClientGetResponseClientURIVerificationStatus = "failed"` - `Text string` Exact TXT record value that must be added to DNS to prove ownership of the client URI host. - `CreatedAt Time` Timestamp when the OAuth client was created. - `GrantTypes []OAuthClientGetResponseGrantType` Array of OAuth grant types the client is allowed to use. `authorization_code` is required; `refresh_token` may be included optionally. - `const OAuthClientGetResponseGrantTypeAuthorizationCode OAuthClientGetResponseGrantType = "authorization_code"` - `const OAuthClientGetResponseGrantTypeRefreshToken OAuthClientGetResponseGrantType = "refresh_token"` - `HasRotatedSecret bool` Indicates whether the client has a rotated secret that has not yet been deleted. - `LogoURI string` URL of the client's logo. - `PolicyURI string` URL that points to a privacy policy document. - `PostLogoutRedirectURIs []string` Array of allowed post-logout redirect URIs. - `PromotedAt Time` Timestamp when the OAuth client was promoted to public visibility. - `RedirectURIs []string` Array of allowed redirect URIs for the client. - `ResponseTypes []OAuthClientGetResponseResponseType` Array of OAuth response types the client is allowed to use. - `const OAuthClientGetResponseResponseTypeToken OAuthClientGetResponseResponseType = "token"` - `const OAuthClientGetResponseResponseTypeIDToken OAuthClientGetResponseResponseType = "id_token"` - `const OAuthClientGetResponseResponseTypeCode OAuthClientGetResponseResponseType = "code"` - `Scopes []string` Array of OAuth scopes the client is allowed to request. Colon-delimited scopes are not accepted. Dot-delimited scopes are validated against available OAuth API scopes; simple identity scopes are allowed. Protocol scopes `offline_access` and `openid` are added or removed automatically based on `grant_types` and `response_types`. - `TokenEndpointAuthMethod OAuthClientGetResponseTokenEndpointAuthMethod` The authentication method the client uses at the token endpoint. - `const OAuthClientGetResponseTokenEndpointAuthMethodNone OAuthClientGetResponseTokenEndpointAuthMethod = "none"` - `const OAuthClientGetResponseTokenEndpointAuthMethodClientSecretBasic OAuthClientGetResponseTokenEndpointAuthMethod = "client_secret_basic"` - `const OAuthClientGetResponseTokenEndpointAuthMethodClientSecretPost OAuthClientGetResponseTokenEndpointAuthMethod = "client_secret_post"` - `TosURI string` URL that points to a terms of service document. - `UpdatedAt Time` Timestamp when the OAuth client was last updated. ### Example ```go package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/iam" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) oauthClient, err := client.IAM.OAuthClients.Get( context.TODO(), "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", iam.OAuthClientGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", oauthClient.ClientID) } ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "client_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "visibility": "private", "allowed_cors_origins": [ "https://example.com" ], "client_name": "My OAuth App", "client_uri": "https://example.com", "client_uri_verification": { "status": "in_progress", "text": "cloudflare_oauth_client_publisher=example" }, "created_at": "2025-01-01T00:00:00Z", "grant_types": [ "authorization_code", "refresh_token" ], "has_rotated_secret": false, "logo_uri": "https://example.com/logo.png", "policy_uri": "https://example.com/privacy", "post_logout_redirect_uris": [ "https://example.com/logout" ], "promoted_at": "2026-05-13T12:00:00Z", "redirect_uris": [ "https://example.com/callback" ], "response_types": [ "code" ], "scopes": [ "account.read" ], "token_endpoint_auth_method": "client_secret_post", "tos_uri": "https://example.com/tos", "updated_at": "2025-01-01T00:00:00Z" } } ```