Use this endpoint to fetch the profile and account details for the currently authenticated user. The response includes your user ID, display name, email address, subscription plan with memory limits, and a full list of all applications in your account. This endpoint is useful for verifying authentication, checking your plan limits, and auditing your hosted applications.
Request
GET https://api.virtuscloud.app/v2/users/me
Your Virtus Cloud API key. Pass it directly as the header value — no prefix required. Example: Authorization: vc_live_xxxxxxxxxxxx
Response
Returns "success" when the request completes successfully.
The complete account information for the authenticated user. Your account profile and plan details. Your unique Virtus Cloud user ID.
Your account display name.
The email address associated with your account.
Details about your current subscription plan. The name of your active plan (e.g., "standard-4").
Memory allocation details for your plan. The total RAM limit included in your plan, in megabytes.
The amount of RAM currently available for new deployments, in megabytes.
The amount of RAM currently consumed by your running applications, in megabytes.
The Unix timestamp in milliseconds indicating when your current plan period ends.
A list of all applications in your Virtus Cloud account. The display name of the application.
The unique identifier of the application.
A short description of the application.
The RAM allocated to the application, in megabytes.
The programming language or runtime of the application (e.g., "javascript", "python").
The auto-assigned Virtus Cloud subdomain for the application.
The custom domain configured for the application, if any.
The name of the cluster where the application is deployed.
A list of managed databases associated with your account. Each item follows the same structure as the database creation response.
Examples
curl -X GET https://api.virtuscloud.app/v2/users/me \
-H "Authorization: <api_key>"
Response Example
{
"status" : "success" ,
"response" : {
"user" : {
"id" : "313397145698959364" ,
"name" : "joaootavios" ,
"email" : "joao@virtuscloud.app" ,
"plan" : {
"name" : "standard-4" ,
"memory" : {
"limit" : 4096 ,
"available" : 3840 ,
"used" : 256
},
"duration" : 1732072955446
}
},
"applications" : [
{
"name" : "VirtusCloud Example APP" ,
"id" : "446b0b4118634a1c99e73bac9a54e475" ,
"desc" : "This is a example of description" ,
"ram" : 512 ,
"lang" : "javascript" ,
"domain" : "square-example-app.virtusapp.cloud" ,
"custom" : "mydomain.com" ,
"cluster" : "suki-cluster"
}
],
"databases" : []
}
}