Skip to main content

Detail LDAP Configuration

This API returns the current LDAP configuration used to connect the system to an LDAP directory server.

Endpoint Details

URL/v1/ldap/config
MethodGET
AuthorizationBearer Token

Request Headers

HeaderTypeDescription
Content-TypeStringMust be application/json

Response

Here is an example of a response when viewing data details:

Response
{
"config": {
"id": "1a4026ed-013e-492e-ab0c-c0133c8fff40",
"host": "ldap.example.com",
"port": 636,
"base_dn": "OU=Users,DC=example,DC=com",
"bind_dn": "CN=Service Account,OU=Users,DC=example,DC=com",
"enabled": true,
"created_at": "2026-05-18T10:04:23+07:00",
"updated_at": "2026-05-18T10:09:14+07:00"
}
}

Field Descriptions

FieldTypeDescription
idUUIDUnique identifier of the LDAP configuration
hostStringHostname or IP address of the LDAP server
portIntegerPort used to connect to the LDAP server
base_dnStringBase distinguished name used as the starting point for searches
bind_dnStringDistinguished name of the account used to bind to the server
sslBooleanIndicates whether the connection uses SSL
enabledBooleanIndicates whether the LDAP configuration is enabled
created_atStringCreation timestamp in RFC 3339 date-time format
updated_atStringLast update timestamp in RFC 3339 date-time format

info
  • A valid Bearer Token is required to access this endpoint.
  • The ssl field may not be present when the connection is not configured to use SSL.
  • Timestamps are returned in RFC 3339 date-time format.