Stytch · Schema

api_user_v1_GetResponse

AuthenticationIdentityPasswordlessSecurityB2BConnected AppsMCPAI AgentsDeveloper Tools

Properties

Name Type Description
request_id string Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug
user_id string The unique ID of the returned User.
emails array An array of email objects for the User.
status string The status of the User. The possible values are `pending` and `active`.
phone_numbers array An array of phone number objects linked to the User.
webauthn_registrations array An array that contains a list of all Passkey or WebAuthn registrations for a given User in the Stytch API.
providers array An array of OAuth `provider` objects linked to the User.
totps array An array containing a list of all TOTP instances for a given User in the Stytch API.
crypto_wallets array An array contains a list of all crypto wallets for a given User in the Stytch API.
biometric_registrations array An array that contains a list of all biometric registrations for a given User in the Stytch API.
is_locked boolean
roles array Roles assigned to this User. See the [RBAC guide](https://stytch.com/docs/guides/rbac/role-assignment) for more information about role assignment.
status_code integer The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server
name object The name of the User. Each field in the `name` object is optional.
created_at string The timestamp of the User's creation. Values conform to the RFC 3339 standard and are expressed in UTC, e.g. `2021-12-29T12:33:09Z`.
password object The password object is returned for users with a password.
trusted_metadata object The `trusted_metadata` field contains an arbitrary JSON object of application-specific data. See the [Metadata](https://stytch.com/docs/api/metadata) reference for complete field behavior details.
untrusted_metadata object The `untrusted_metadata` field contains an arbitrary JSON object of application-specific data. Untrusted metadata can be edited by end users directly via the SDK, and **cannot be used to store critica
external_id string
lock_created_at string
lock_expires_at string
View JSON Schema on GitHub

JSON Schema

stytch-api-user-v1-getresponse-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/api_user_v1_GetResponse",
  "title": "api_user_v1_GetResponse",
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "description": "Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue."
    },
    "user_id": {
      "type": "string",
      "description": "The unique ID of the returned User."
    },
    "emails": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_Email"
      },
      "description": "An array of email objects for the User."
    },
    "status": {
      "type": "string",
      "description": "The status of the User. The possible values are `pending` and `active`."
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_PhoneNumber"
      },
      "description": "An array of phone number objects linked to the User."
    },
    "webauthn_registrations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_WebAuthnRegistration"
      },
      "description": "An array that contains a list of all Passkey or WebAuthn registrations for a given User in the Stytch API."
    },
    "providers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_OAuthProvider"
      },
      "description": "An array of OAuth `provider` objects linked to the User."
    },
    "totps": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_TOTP"
      },
      "description": "An array containing a list of all TOTP instances for a given User in the Stytch API."
    },
    "crypto_wallets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_CryptoWallet"
      },
      "description": "An array contains a list of all crypto wallets for a given User in the Stytch API."
    },
    "biometric_registrations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/api_user_v1_BiometricRegistration"
      },
      "description": "An array that contains a list of all biometric registrations for a given User in the Stytch API."
    },
    "is_locked": {
      "type": "boolean"
    },
    "roles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Roles assigned to this User.\n   See the [RBAC guide](https://stytch.com/docs/guides/rbac/role-assignment) for more information about role assignment."
    },
    "status_code": {
      "type": "integer",
      "format": "int32",
      "description": "The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors."
    },
    "name": {
      "$ref": "#/components/schemas/api_user_v1_Name",
      "description": "The name of the User. Each field in the `name` object is optional."
    },
    "created_at": {
      "type": "string",
      "description": "The timestamp of the User's creation. Values conform to the RFC 3339 standard and are expressed in UTC, e.g. `2021-12-29T12:33:09Z`."
    },
    "password": {
      "$ref": "#/components/schemas/api_user_v1_Password",
      "description": "The password object is returned for users with a password."
    },
    "trusted_metadata": {
      "type": "object",
      "additionalProperties": true,
      "description": "The `trusted_metadata` field contains an arbitrary JSON object of application-specific data. See the [Metadata](https://stytch.com/docs/api/metadata) reference for complete field behavior details."
    },
    "untrusted_metadata": {
      "type": "object",
      "additionalProperties": true,
      "description": "The `untrusted_metadata` field contains an arbitrary JSON object of application-specific data. Untrusted metadata can be edited by end users directly via the SDK, and **cannot be used to store critical information.** See the [Metadata](https://stytch.com/docs/api/metadata) reference for complete field behavior details."
    },
    "external_id": {
      "type": "string"
    },
    "lock_created_at": {
      "type": "string"
    },
    "lock_expires_at": {
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "user_id",
    "emails",
    "status",
    "phone_numbers",
    "webauthn_registrations",
    "providers",
    "totps",
    "crypto_wallets",
    "biometric_registrations",
    "is_locked",
    "roles",
    "status_code"
  ]
}