> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a realm

> Get a realm's configuration details.



## OpenAPI

````yaml /api-reference/5.9/fusion-api-api-docs.json get /realm-configs/{id}
openapi: 3.0.1
info:
  title: Fusion Proxy API
  description: Manage Fusion users, roles, realms, access tokens, and API keys.
  contact:
    name: Lucidworks
    url: www.lucidworks.com
    email: support@lucidworks.com
  license:
    name: License of API
    url: https://lucidworks.com/legal/developer-license-agreement/
  version: '5.9'
servers:
  - url: https://{FUSION HOST}/api
    description: Fusion
    variables:
      FUSION HOST:
        default: FUSION_HOST
        description: Your environment host.
security: []
tags:
  - name: Realm management
    description: >-
      Endpoints for creating, configuring, and managing authentication realms
      such as LDAP, SAML, OIDC, and others.
  - name: User management
    description: >-
      Endpoints for creating, updating, deleting, and retrieving Fusion users
      and their associated metadata.
  - name: Suggestions
    description: >-
      Endpoints that provide query suggestions or autocomplete results to
      improve search experiences.
  - name: API key management
    description: >-
      Endpoints for managing API keys used to authenticate Fusion services and
      integrations.
  - name: OAuth 2.0
    description: >-
      Endpoints that support OAuth 2.0 authentication, including token issuance
      and validation.
  - name: Role management
    description: >-
      Endpoints for creating and managing user roles and their associated
      permissions within Fusion.
  - name: System status
    description: >-
      Endpoints for retrieving basic system health, configuration, and
      authentication status.
externalDocs:
  description: Lucidworks Documentation
  url: https://doc.lucidworks.com/
paths:
  /realm-configs/{id}:
    get:
      tags:
        - Realm management
      summary: Get a realm
      description: Get a realm's configuration details.
      operationId: getRealm
      parameters:
        - name: id
          description: >-
            The realm ID. Note that this is not always the same as the realm
            name. Use `GET /realm-configs/default` to get the list of realm
            names with their IDs.
          example: df32cba0-5540-4d73-b769-9f4eaca45e11
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                type: object
              example:
                realmType: ldap
                id: df32cba0-5540-4d73-b769-9f4eaca45e11
                name: dev-ldap3
                enabled: false
                createdAt: '2025-10-31T17:06:33Z'
                updatedAt: '2025-10-31T17:35:08Z'
                config:
                  autoCreateUsers: true
                  host: my.fusionhost.com
                  ssl: true
                  port: 10636
                  ephemeralUsers: false
                  login:
                    bindDnTemplate: uid={},ou=users,dc=security,dc=example,dc=com
        '404':
          description: Realm not found

````