Get public interaction data

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi.logto.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Logto API references MCP server": {
    "url": "https://openapi.logto.io/mcp"
  }
}
Close
GET /api/experience/interaction

Get the public interaction data. When the interaction was created from a login prompt that carries requested acr_values, the response includes the authenticationContext with the methods that can still contribute to the selected class, evaluated on every read.

Responses

  • 200 application/json

    The public interaction data has been successfully retrieved.

    Hide response attributes Show response attributes object
    • interactionEvent string Required

      Values are SignIn, Register, or ForgotPassword.

    • userId string
    • authenticationContext object
      Hide authenticationContext attributes Show authenticationContext attributes object
      • requestedAcrValues array[string] Required

        Values are urn:logto:acr:1fa or urn:logto:acr:mfa.

      • selectedAcr string

        Values are urn:logto:acr:1fa or urn:logto:acr:mfa.

      • mode string

        Value is stepUp.

      • availableMethods array[string] Required

        Values are Password, EmailVerificationCode, PhoneVerificationCode, MfaEmailVerificationCode, MfaPhoneVerificationCode, Social, EnterpriseSso, Totp, WebAuthn, SignInPasskey, BackupCode, NewPasswordIdentity, or OneTimeToken.

      • establishableMethods array[string] Required

        Values are username, email, phone, password, emailOrPhone, or extraProfile.

      • enrollableFactors array[string] Required

        Values are Totp, WebAuthn, BackupCode, EmailVerificationCode, or PhoneVerificationCode.

      • subjectProofConnectors array[object] Required
        Hide subjectProofConnectors attributes Show subjectProofConnectors attributes object
        • type string Required

          Values are social or sso.

        • connectorId string Required
      • maskedIdentifiers object Required
        Hide maskedIdentifiers attributes Show maskedIdentifiers attributes object
        • email string
        • phone string
    • profile object Required
      Hide profile attributes Show profile attributes object
      • avatar string | null

        Maximum length is 2048.

      • name string | null

        Maximum length is 128.

      • username string | null

        Maximum length is 128.

      • primaryEmail string | null

        Maximum length is 128.

      • primaryPhone string | null

        Maximum length is 128.

      • profile object
        Hide profile attributes Show profile attributes object
        • familyName string
        • givenName string
        • middleName string
        • nickname string
        • preferredUsername string
        • profile string
        • website string
        • gender string
        • birthdate string
        • zoneinfo string
        • locale string
        • address object
          Hide address attributes Show address attributes object
          • formatted string
          • streetAddress string
          • locality string
          • region string
          • postalCode string
          • country string
      • customData object

        arbitrary

        Additional properties are allowed.

      • socialIdentity object
        Hide socialIdentity attributes Show socialIdentity attributes object
      • enterpriseSsoIdentity object
        Hide enterpriseSsoIdentity attributes Show enterpriseSsoIdentity attributes object
        • identityId string Required

          Minimum length is 1, maximum length is 128.

        • ssoConnectorId string Required

          Minimum length is 1, maximum length is 128.

        • issuer string Required

          Minimum length is 1, maximum length is 256.

        • detail object Required

          arbitrary

          Additional properties are allowed.

      • syncedEnterpriseSsoIdentity object
        Hide syncedEnterpriseSsoIdentity attributes Show syncedEnterpriseSsoIdentity attributes object
        • identityId string Required

          Minimum length is 1, maximum length is 128.

        • issuer string Required

          Minimum length is 1, maximum length is 256.

        • detail object Required

          arbitrary

          Additional properties are allowed.

      • jitOrganizationIds array[string]
      • submitted boolean
    • verificationRecords array[object]
      One of:
      object-1 object object-2 object object-3 object object-4 object object-5 object object-6 object object-7 object object-8 object object-9 object object-10 object object-11 object object-12 object object-13 object
    • mfa object
      Hide mfa attributes Show mfa attributes object
      • mfaEnabled boolean
      • mfaSkipped boolean
      • passkeySkipped boolean
      • totp object
        Hide totp attribute Show totp attribute object
        • type string("Totp") Required
      • webAuthn array[object]
        Hide webAuthn attributes Show webAuthn attributes object
        • type string("WebAuthn") Required
        • rpId string Required
        • credentialId string Required
        • publicKey string Required
        • transports array[string] Required

          Values are usb, nfc, ble, internal, cable, hybrid, or smart-card.

        • counter number Required
        • agent string Required
        • name string
      • backupCode object
        Hide backupCode attribute Show backupCode attribute object
        • type string("BackupCode") Required
    • signInContext object
      Hide signInContext attribute Show signInContext attribute object
      • * string Additional properties
    • captcha object
      Hide captcha attributes Show captcha attributes object
      • verified boolean Required
      • skipped boolean Required
  • 404

    The pinned subject of the step-up interaction no longer exists.

GET /api/experience/interaction 
curl \
 --request GET 'https://[tenant_id].logto.app/api/experience/interaction'
Response examples (200) 
{
  "interactionEvent": "SignIn",
  "userId": "string",
  "authenticationContext": {
    "requestedAcrValues": [
      "urn:logto:acr:1fa"
    ],
    "selectedAcr": "urn:logto:acr:1fa",
    "mode": "stepUp",
    "availableMethods": [
      "Password"
    ],
    "establishableMethods": [
      "username"
    ],
    "enrollableFactors": [
      "Totp"
    ],
    "subjectProofConnectors": [
      {
        "type": "social",
        "connectorId": "string"
      }
    ],
    "maskedIdentifiers": {
      "email": "string",
      "phone": "string"
    }
  },
  "profile": {
    "avatar": "string",
    "name": "string",
    "username": "string",
    "primaryEmail": "string",
    "primaryPhone": "string",
    "profile": {
      "familyName": "string",
      "givenName": "string",
      "middleName": "string",
      "nickname": "string",
      "preferredUsername": "string",
      "profile": "string",
      "website": "string",
      "gender": "string",
      "birthdate": "string",
      "zoneinfo": "string",
      "locale": "string",
      "address": {
        "formatted": "string",
        "streetAddress": "string",
        "locality": "string",
        "region": "string",
        "postalCode": "string",
        "country": "string"
      }
    },
    "customData": {},
    "socialIdentity": {
      "target": "string",
      "userInfo": {
        "id": "string",
        "email": "string",
        "phone": "string",
        "name": "string",
        "avatar": "string",
        "rawData": {}
      }
    },
    "enterpriseSsoIdentity": {
      "identityId": "string",
      "ssoConnectorId": "string",
      "issuer": "string",
      "detail": {}
    },
    "syncedEnterpriseSsoIdentity": {
      "identityId": "string",
      "issuer": "string",
      "detail": {}
    },
    "jitOrganizationIds": [
      "string"
    ],
    "submitted": true
  },
  "verificationRecords": [
    {
      "id": "string",
      "type": "string",
      "identifier": {
        "type": "username",
        "value": "string"
      },
      "verified": true
    }
  ],
  "mfa": {
    "mfaEnabled": true,
    "mfaSkipped": true,
    "passkeySkipped": true,
    "totp": {
      "type": "string"
    },
    "webAuthn": [
      {
        "type": "string",
        "rpId": "string",
        "credentialId": "string",
        "publicKey": "string",
        "transports": [
          "usb"
        ],
        "counter": 42.0,
        "agent": "string",
        "name": "string"
      }
    ],
    "backupCode": {
      "type": "string"
    }
  },
  "signInContext": {
    "additionalProperty1": "string",
    "additionalProperty2": "string"
  },
  "captcha": {
    "verified": true,
    "skipped": true
  }
}