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

# Discovery · Humanity config

<Callout>
  **SDK equivalent**

  ```ts theme={null}
  const config = await sdk.getConfiguration();
  ```
</Callout>

Returns Humanity-specific metadata that complements the standard OIDC discovery document:

* Available preset catalog with labels and descriptions
* OAuth endpoints (authorize, token, revoke, JWKS)
* Environment-level feature flags and SLA hints

Call this during bootstrap to populate your UX or to double-check which presets are GA in the current region. Combine it with `/.well-known/openid-configuration` and `/.well-known/jwks.json` for full OIDC compliance.


## OpenAPI

````yaml api-reference/openapi.json get /.well-known/hp-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/hp-configuration:
    get:
      tags: []
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HpConfiguration'
components:
  schemas:
    HpConfiguration:
      type: object
      properties:
        issuer:
          type: string
        authorization_endpoint:
          type: string
        token_endpoint:
          type: string
        revoke_endpoint:
          type: string
        userinfo_endpoint:
          type: string
        jwks_uri:
          type: string
        presets_endpoint:
          type: string
        presets_batch_endpoint:
          type: string
        credentials_endpoint:
          type: string
        authorizations_endpoint:
          type: string
        hp_configuration_endpoint:
          type: string
        scopes_supported:
          type: array
          items:
            type: string
        scopes_catalog:
          type: array
          items:
            $ref: '#/components/schemas/HpScopeDescriptor'
        grant_types_supported:
          type: array
          items:
            type: string
        code_challenge_methods_supported:
          type: array
          items:
            type: string
        response_types_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
        presets_available:
          type: array
          items:
            $ref: '#/components/schemas/HpConfigurationPreset'
        rate_limit_default:
          type: number
        rate_limit_unit:
          type: string
      required:
        - issuer
        - authorization_endpoint
        - token_endpoint
        - revoke_endpoint
        - userinfo_endpoint
        - jwks_uri
        - presets_endpoint
        - presets_batch_endpoint
        - credentials_endpoint
        - authorizations_endpoint
        - hp_configuration_endpoint
        - scopes_supported
        - scopes_catalog
        - grant_types_supported
        - code_challenge_methods_supported
        - response_types_supported
        - token_endpoint_auth_methods_supported
        - subject_types_supported
        - claim_types_supported
        - claims_supported
        - id_token_signing_alg_values_supported
        - presets_available
        - rate_limit_default
        - rate_limit_unit
    HpScopeDescriptor:
      type: object
      properties:
        id:
          type: string
        display_name:
          type: string
        description:
          type: string
        category:
          type: string
        implied_scopes:
          type: array
          items:
            type: string
        is_default:
          type: boolean
      required:
        - id
        - display_name
        - description
        - category
    HpConfigurationPreset:
      type: object
      properties:
        name:
          oneOf:
            - const: humanity_uuid
            - const: humanity_score
            - const: is_human
            - const: country_of_residence
            - const: age
            - const: address_postal_code
            - const: legal_name
            - const: residency_region
            - const: age_over_18
            - const: nationality
            - const: address_full
            - const: date_of_birth
            - const: email
            - const: phone
            - const: age_over_21
            - const: social_accounts
            - const: wallet_address
            - const: primary_wallet_address
            - const: kyc_passed
            - const: kyc_last_updated_at
            - const: document_number
            - const: document_country
            - const: document_expiry_date
            - const: net_worth_above_10k
            - const: net_worth_above_100k
            - const: net_worth_total
            - const: bank_balance_total
            - const: loan_balance_total
            - const: google_connected
            - const: linkedin_connected
            - const: facebook_connected
            - const: twitter_connected
            - const: discord_connected
            - const: github_connected
            - const: telegram_connected
            - const: palm_verified
            - const: humanity_user
            - const: proof_of_assets
            - const: proof_of_investments
            - const: proof_of_mortgage
            - const: proof_of_residency
            - const: proof_of_retirement
        scope:
          type: string
        type:
          oneOf:
            - const: string
            - const: number
            - const: boolean
            - const: integer
            - const: date
            - const: datetime
            - const: array
            - const: enum
            - const: bundled
        description:
          type: string
        consent_text:
          type: string
      required:
        - name
        - scope
        - type
        - description
        - consent_text

````