> ## Documentation Index
> Fetch the complete documentation index at: https://humanity-eaeda8f6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OIDC · Discovery document

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`.


## OpenAPI

````yaml api-reference/openapi.json get /.well-known/openid-configuration
openapi: 3.1.0
info:
  version: 0.1.0
  title: hp-public-dev-api-server
  description: NestJS CQRS + TDD base for Humanity Public Dev API
servers:
  - url: https://api.sandbox.humanity.org/v2
    description: Sandbox environment for development and testing
  - url: https://api.humanity.org/v2
    description: Production environment
security: []
tags: []
paths:
  /.well-known/openid-configuration:
    get:
      tags: []
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenIdConfiguration'
components:
  schemas:
    OpenIdConfiguration:
      type: object
      properties:
        issuer:
          type: string
        authorization_endpoint:
          type: string
        token_endpoint:
          type: string
        userinfo_endpoint:
          type: string
        jwks_uri:
          type: string
        response_types_supported:
          type: array
          items:
            type: string
        grant_types_supported:
          type: array
          items:
            type: string
        scopes_supported:
          type: array
          items:
            type: string
        code_challenge_methods_supported:
          type: array
          items:
            type: string
        token_endpoint_auth_methods_supported:
          type: array
          items:
            type: string
        subject_types_supported:
          type: array
          items:
            type: string
        claim_types_supported:
          type: array
          items:
            type: string
        claims_supported:
          type: array
          items:
            type: string
        id_token_signing_alg_values_supported:
          type: array
          items:
            type: string
        revocation_endpoint:
          type: string
        revocation_endpoint_auth_methods_supported:
          type: array
          items:
            type: string
      required:
        - issuer
        - authorization_endpoint
        - token_endpoint
        - userinfo_endpoint
        - jwks_uri
        - response_types_supported
        - grant_types_supported
        - scopes_supported
        - code_challenge_methods_supported
        - token_endpoint_auth_methods_supported
        - subject_types_supported
        - claim_types_supported
        - claims_supported
        - id_token_signing_alg_values_supported
        - revocation_endpoint

````