OIDC · Discovery document

GET /.well-known/openid-configuration

cURL

cURL

curl --request GET \
  --url https://api.sandbox.humanity.org/v2/.well-known/openid-configuration

import requests

url = "https://api.sandbox.humanity.org/v2/.well-known/openid-configuration"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.sandbox.humanity.org/v2/.well-known/openid-configuration', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sandbox.humanity.org/v2/.well-known/openid-configuration",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sandbox.humanity.org/v2/.well-known/openid-configuration"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.sandbox.humanity.org/v2/.well-known/openid-configuration")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.humanity.org/v2/.well-known/openid-configuration")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

200

{
  "issuer": "<string>",
  "authorization_endpoint": "<string>",
  "token_endpoint": "<string>",
  "userinfo_endpoint": "<string>",
  "jwks_uri": "<string>",
  "response_types_supported": [
    "<string>"
  ],
  "grant_types_supported": [
    "<string>"
  ],
  "scopes_supported": [
    "<string>"
  ],
  "code_challenge_methods_supported": [
    "<string>"
  ],
  "token_endpoint_auth_methods_supported": [
    "<string>"
  ],
  "subject_types_supported": [
    "<string>"
  ],
  "claim_types_supported": [
    "<string>"
  ],
  "claims_supported": [
    "<string>"
  ],
  "id_token_signing_alg_values_supported": [
    "<string>"
  ],
  "revocation_endpoint": "<string>",
  "revocation_endpoint_auth_methods_supported": [
    "<string>"
  ]
}

Expose the standard OpenID Connect discovery document, covering issuer metadata, OAuth endpoints, supported grant types, signing algorithms, and claims. Feed this into generic OIDC clients to configure Humanity automatically.

Typically retrieved alongside /.well-known/jwks.json and /.well-known/hp-configuration.

Response

200 - application/json

issuer · string · required

authorization_endpoint · string · required

token_endpoint · string · required

userinfo_endpoint · string · required

jwks_uri · string · required

response_types_supported · string[] · required

grant_types_supported · string[] · required

scopes_supported · string[] · required

code_challenge_methods_supported · string[] · required

token_endpoint_auth_methods_supported · string[] · required

subject_types_supported · string[] · required

claim_types_supported · string[] · required

claims_supported · string[] · required

id_token_signing_alg_values_supported · string[] · required

revocation_endpoint · string · required

revocation_endpoint_auth_methods_supported · string[]