Get user

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_user \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "userId": "<string>"
}'

{
  "user": {
    "userId": "<string>",
    "userName": "<string>",
    "userEmail": "<string>",
    "userPhoneNumber": "<string>",
    "authenticators": [
      {
        "transports": [
          "<AUTHENTICATOR_TRANSPORT_BLE>"
        ],
        "attestationType": "<string>",
        "aaguid": "<string>",
        "credentialId": "<string>",
        "model": "<string>",
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "authenticatorId": "<string>",
        "authenticatorName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "apiKeys": [
      {
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "apiKeyId": "<string>",
        "apiKeyName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "expirationSeconds": "<string>"
      }
    ],
    "userTags": [
      "<string>"
    ],
    "oauthProviders": [
      {
        "providerId": "<string>",
        "providerName": "<string>",
        "issuer": "<string>",
        "audience": "<string>",
        "subject": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "createdAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    },
    "updatedAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    }
  }
}

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_user \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "userId": "<string>"
}'

{
  "user": {
    "userId": "<string>",
    "userName": "<string>",
    "userEmail": "<string>",
    "userPhoneNumber": "<string>",
    "authenticators": [
      {
        "transports": [
          "<AUTHENTICATOR_TRANSPORT_BLE>"
        ],
        "attestationType": "<string>",
        "aaguid": "<string>",
        "credentialId": "<string>",
        "model": "<string>",
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "authenticatorId": "<string>",
        "authenticatorName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "apiKeys": [
      {
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "apiKeyId": "<string>",
        "apiKeyName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "expirationSeconds": "<string>"
      }
    ],
    "userTags": [
      "<string>"
    ],
    "oauthProviders": [
      {
        "providerId": "<string>",
        "providerName": "<string>",
        "issuer": "<string>",
        "audience": "<string>",
        "subject": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "createdAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    },
    "updatedAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    }
  }
}

POST

public

query

get_user

Authorizations

X-Stamp

string

required

Cryptographically signed (stamped) request to be passed in as a header. For more info, see here.

Body

organizationId

string

required

Unique identifier for a given organization.

userId

string

required

Unique identifier for a given user.

Response

A successful response returns the following fields:

user

object

required

user field

Show user details

user.userId

string

required

Unique identifier for a given User.

user.userName

string

required

Human-readable name for a User.

user.userEmail

string

The user’s email address.

user.userPhoneNumber

string

The user’s phone number in E.164 format e.g. +13214567890

user.authenticators

array

required

A list of Authenticator parameters.

Show authenticators details

user.authenticators.transports

array

required

Types of transports that may be used by an Authenticator (e.g., USB, NFC, BLE).

Show transports details

user.authenticators.transports.item

enum

required

item fieldEnum options: AUTHENTICATOR_TRANSPORT_BLE, AUTHENTICATOR_TRANSPORT_INTERNAL, AUTHENTICATOR_TRANSPORT_NFC, AUTHENTICATOR_TRANSPORT_USB, AUTHENTICATOR_TRANSPORT_HYBRID

user.authenticators.attestationType

string

required

attestationType field

user.authenticators.aaguid

string

required

Identifier indicating the type of the Security Key.

user.authenticators.credentialId

string

required

Unique identifier for a WebAuthn credential.

user.authenticators.model

string

required

The type of Authenticator device.

user.authenticators.credential

object

required

credential field

Show credential details

user.authenticators.credential.publicKey

string

required

The public component of a cryptographic key pair used to sign messages and transactions.

user.authenticators.credential.type

enum

required

type fieldEnum options: CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR, CREDENTIAL_TYPE_API_KEY_P256, CREDENTIAL_TYPE_RECOVER_USER_KEY_P256, CREDENTIAL_TYPE_API_KEY_SECP256K1, CREDENTIAL_TYPE_EMAIL_AUTH_KEY_P256, CREDENTIAL_TYPE_API_KEY_ED25519, CREDENTIAL_TYPE_OTP_AUTH_KEY_P256, CREDENTIAL_TYPE_READ_WRITE_SESSION_KEY_P256, CREDENTIAL_TYPE_OAUTH_KEY_P256, CREDENTIAL_TYPE_LOGIN

user.authenticators.authenticatorId

string

required

Unique identifier for a given Authenticator.

user.authenticators.authenticatorName

string

required

Human-readable name for an Authenticator.

user.authenticators.createdAt

object

required

createdAt field

Show createdAt details

user.authenticators.createdAt.seconds

string

required

seconds field

user.authenticators.createdAt.nanos

string

required

nanos field

user.authenticators.updatedAt

object

required

updatedAt field

Show updatedAt details

user.authenticators.updatedAt.seconds

string

required

seconds field

user.authenticators.updatedAt.nanos

string

required

nanos field

user.apiKeys

array

required

A list of API Key parameters. This field, if not needed, should be an empty array in your request body.

Show apiKeys details

user.apiKeys.credential

object

required

credential field

Show credential details

user.apiKeys.credential.publicKey

string

required

The public component of a cryptographic key pair used to sign messages and transactions.

user.apiKeys.credential.type

enum

required

user.apiKeys.apiKeyId

string

required

Unique identifier for a given API Key.

user.apiKeys.apiKeyName

string

required

Human-readable name for an API Key.

user.apiKeys.createdAt

object

required

createdAt field

Show createdAt details

user.apiKeys.createdAt.seconds

string

required

seconds field

user.apiKeys.createdAt.nanos

string

required

nanos field

user.apiKeys.updatedAt

object

required

updatedAt field

Show updatedAt details

user.apiKeys.updatedAt.seconds

string

required

seconds field

user.apiKeys.updatedAt.nanos

string

required

nanos field

user.apiKeys.expirationSeconds

string

Optional window (in seconds) indicating how long the API Key should last.

user.userTags

array

required

A list of User Tag IDs.

Show userTags details

user.userTags.item

string

required

item field

user.oauthProviders

array

required

A list of Oauth Providers.

Show oauthProviders details

user.oauthProviders.providerId

string

required

Unique identifier for an OAuth Provider

user.oauthProviders.providerName

string

required

Human-readable name to identify a Provider.

user.oauthProviders.issuer

string

required

The issuer of the token, typically a URL indicating the authentication server, e.g https://accounts.google.com

user.oauthProviders.audience

string

required

Expected audience (‘aud’ attribute of the signed token) which represents the app ID

user.oauthProviders.subject

string

required

Expected subject (‘sub’ attribute of the signed token) which represents the user ID

user.oauthProviders.createdAt

object

required

createdAt field

Show createdAt details

user.oauthProviders.createdAt.seconds

string

required

seconds field

user.oauthProviders.createdAt.nanos

string

required

nanos field

user.oauthProviders.updatedAt

object

required

updatedAt field

Show updatedAt details

user.oauthProviders.updatedAt.seconds

string

required

seconds field

user.oauthProviders.updatedAt.nanos

string

required

nanos field

user.createdAt

object

required

createdAt field

Show createdAt details

user.createdAt.seconds

string

required

seconds field

user.createdAt.nanos

string

required

nanos field

user.updatedAt

object

required

updatedAt field

Show updatedAt details

user.updatedAt.seconds

string

required

seconds field

user.updatedAt.nanos

string

required

nanos field

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_user \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "userId": "<string>"
}'

{
  "user": {
    "userId": "<string>",
    "userName": "<string>",
    "userEmail": "<string>",
    "userPhoneNumber": "<string>",
    "authenticators": [
      {
        "transports": [
          "<AUTHENTICATOR_TRANSPORT_BLE>"
        ],
        "attestationType": "<string>",
        "aaguid": "<string>",
        "credentialId": "<string>",
        "model": "<string>",
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "authenticatorId": "<string>",
        "authenticatorName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "apiKeys": [
      {
        "credential": {
          "publicKey": "<string>",
          "type": "<CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR>"
        },
        "apiKeyId": "<string>",
        "apiKeyName": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "expirationSeconds": "<string>"
      }
    ],
    "userTags": [
      "<string>"
    ],
    "oauthProviders": [
      {
        "providerId": "<string>",
        "providerName": "<string>",
        "issuer": "<string>",
        "audience": "<string>",
        "subject": "<string>",
        "createdAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        },
        "updatedAt": {
          "seconds": "<string>",
          "nanos": "<string>"
        }
      }
    ],
    "createdAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    },
    "updatedAt": {
      "seconds": "<string>",
      "nanos": "<string>"
    }
  }
}

Get sub-organizations Get verified sub-organizations

Activities

Queries

Authorizations

Body

Response