Use this endpoint to get SAML entity details for your account. If no SAML entity has been set, this endpoint returns and empty JSON object.

Example requests and responses

curl -X GET \ \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
import requests

url = ""

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"

response = requests.request("GET", url, data=payload, headers=headers)

package main

import (

func main() {

	url := ""

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

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

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

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


var request = require("request");

var options = { method: 'GET',
  url: '',
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

200 OK
  "id": "11223",
  "account_id": "123456",
  "xml_metadata": "{{idp_xml_metadata}}",
  "source_url": "{{source_url}}",
  "idp_entity_id": "{{idp_entity_url}}",
  "attribute_mapping": "{\"username\":\"NameID\"}",
  "friendly_name": "Your Company, Inc.",
  "friendly_slug": "your-company-inc",
  "date_created": "2017-06-24 13:24:58",
  "last_signon_date": "2019-01-13 14:36:49",
  "username_attribute": "NameID",
  "type": "login"
200 OK (SAML not enabled)

Response parameters

Name Type Description
id string ID of the SAML entity.
account_id string Account ID.
xml_metadata string SAML XML metadata gathered from the specified dynamic URL or entered manually.
source_url string URL for the IdP service where XML metadata can be gathered.
Returned only if a URL is being used to gather XML metadata dynamically.
idp_entity_id string IdP entity URL parsed from the XML metadata.
attribute_mapping string Attribute used to map CertCentral users to SAML SSO users.
friendly_name string Display name used for your SSO sign on page. This value is also used to generate the friendly slug.
friendly_slug string Friendly slug version of the friendly name.
This value is used to create your SAML SSO URL.
date_created string Timestamp of when the SAML entity was created.
Format: yyyy-MM-dd HH:mm:ss
last_signon_date string Timestamp of the last time SAML SSO was used.
Format: yyyy-MM-dd HH:mm:ss
username_attribute string Name of the attribute that is used to map CertCentral users to SAML SSO users.
type string SAML entity type.