Active Sessions

Used to interact with the sessions of the current user.

Get Active Sessions

Returns all active session for user, including activity information.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

query Parameters

_clerk_session_id

string

The session_id associated with the requesting user.

Responses

200

Returns an Active Sessions array.

401

Request was not successful

get/v1/me/sessions/active

Response samples

application/json

[{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"backup_codes": ["string"
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": "unverified",
"strategy": "passkey",
"attempts": 0,
"expire_at": 0,
"nonce": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": "string",
"object": "organization",
"name": "string",
"max_allowed_memberships": 0,
"admin_delete_enabled": true,
"slug": "string",
"logo_url": "string",
"image_url": "string",
"has_image": true,
"members_count": 0,
"pending_invitations_count": 0,
"public_metadata": { },
"created_at": 0,
"updated_at": 0
},
"public_user_data": {"user_id": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": "unverified",
"strategy": "saml",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"saml_connection": {"id": "string",
"name": "string",
"domain": "string",
"active": true,
"provider": "string",
"sync_user_attributes": true,
"allow_subdomains": true,
"allow_idp_initiated": true,
"disable_additional_identifications": true,
"created_at": 0,
"updated_at": 0
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
},
"latest_activity": {"object": "string",
"id": "string",
"device_type": "string",
"is_mobile": true,
"browser_name": "string",
"browser_version": "string",
"ip_address": "string",
"city": "string",
"country": "string"
}
}
]

Revoke given session

Revokes given session.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

session_id

required

string

The session id to be revoked.

query Parameters

_clerk_session_id

string

The session_id associated with the requesting user.

Responses

200

Returns a Session object.

400

Request was not successful

401

Request was not successful

403

Request was not successful

404

Request was not successful

post/v1/me/sessions/{session_id}/revoke

Response samples

application/json

{"response": {"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"backup_codes": ["string"
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": "unverified",
"strategy": "passkey",
"attempts": 0,
"expire_at": 0,
"nonce": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": "string",
"object": "organization",
"name": "string",
"max_allowed_memberships": 0,
"admin_delete_enabled": true,
"slug": "string",
"logo_url": "string",
"image_url": "string",
"has_image": true,
"members_count": 0,
"pending_invitations_count": 0,
"public_metadata": { },
"created_at": 0,
"updated_at": 0
},
"public_user_data": {"user_id": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": "unverified",
"strategy": "saml",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"saml_connection": {"id": "string",
"name": "string",
"domain": "string",
"active": true,
"provider": "string",
"sync_user_attributes": true,
"allow_subdomains": true,
"allow_idp_initiated": true,
"disable_additional_identifications": true,
"created_at": 0,
"updated_at": 0
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
},
"client": {"object": "client",
"id": "string",
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true
},
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"created_session_id": "string",
"abandon_at": 0
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 0,
"legal_accepted_at": 1700690400000
},
"sessions": [{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"slug": null,
"logo_url": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"public_metadata": { },
"created_at": null,
"updated_at": null
},
"public_user_data": {"user_id": null,
"first_name": null,
"last_name": null,
"profile_image_url": null,
"image_url": null,
"has_image": null,
"identifier": null
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"last_active_session_id": "string",
"updated_at": 0,
"created_at": 0
}
}

Get Sessions

Get all the sessions of the current user.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

query Parameters

_clerk_session_id

string

The session_id associated with the requesting user.

Responses

200

Returns Sessions array.

401

Request was not successful

403

Request was not successful

404

Request was not successful

get/v1/me/sessions

Response samples

application/json

[{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"linked_to": [{"type": "oauth_apple",
"id": "string"
}
],
"backup_codes": ["string"
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": "unverified",
"strategy": "passkey",
"attempts": 0,
"expire_at": 0,
"nonce": "string"
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": "string",
"object": "organization",
"name": "string",
"max_allowed_memberships": 0,
"admin_delete_enabled": true,
"slug": "string",
"logo_url": "string",
"image_url": "string",
"has_image": true,
"members_count": 0,
"pending_invitations_count": 0,
"public_metadata": { },
"created_at": 0,
"updated_at": 0
},
"public_user_data": {"user_id": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": "unverified",
"strategy": "saml",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
},
"saml_connection": {"id": "string",
"name": "string",
"domain": "string",
"active": true,
"provider": "string",
"sync_user_attributes": true,
"allow_subdomains": true,
"allow_idp_initiated": true,
"disable_additional_identifications": true,
"created_at": 0,
"updated_at": 0
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
]

➔ Next to Email Addresses