Function getClientByHomeRealm

GET /clients/home-realm – Retrieves details of a specific client application by its home realm.

---

📥 Request

Headers:

• No Authorization header required
• Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

• None

Path Parameters:

• None Query Parameters:
• provider: The authentication provider (optional). Defaults to auth0-client if omitted. See ClientProvider.
• product: The product identifier associated with the client (required). See ProductKey.
• subdomain: The subdomain associated with the client (required).

---

📤 Response

• 200 OK – Returns the client Client.

---

❗ Errors

Status Code	Meaning	When it Happens
400	Bad Request	Missing or invalid fields in request body
401	Unauthorized	Missing or invalid authentication token
404	Not Found	Specified client does not exist
500	Internal Server Error	Unexpected error

Error Response Format

{
  "error": "Detailed error message here"
}
Copy

---

📦 Examples

📥 Auth0 Request

GET /clients/home-realm?product=exampleProduct&subdomain=exampleSubdomain
Copy

📥 Cognito Request

GET /clients/home-realm?product=exampleProduct&subdomain=exampleSubdomain&provider=cognito-client
Copy

📤 Response Example

	{
		"id": "clientId",
		"name": "string",
		"secret": "string",
		"callbacks": ["string"],
		"allowedLogoutUrls": ["string"],
		"grantTypes": ["string"],
		"tokenEndpointAuthMethod": "string",
		"supportedIdp": ["string"],
		"description": "string",
		"webOrigins": ["string"],
		"appType": "string",
		"clientMetadata": { "key": "value" },
		"disabled": false,
		"oidcConformant": true,
		"auth0Id": "string"
		// More fields may be present depending on the provider
	}
Copy

---