Get User Organizations

curl --request GET \
  --url https://api.vertracloud.app/v1/organizations/all/{id} \
  --header 'Authorization: Bearer <token>'

{
  "status": "success",
  "response": [
    {
      "id": "org123",
      "name": "myorganization",
      "description": "I have a description :)",
      "tags": ["discord", "programming"],
      "owner_id": "993591427428790342",
      "plan_id": 1,
      "members": [
        {
          "user_id": "993591427428790342",
          "role": "owner",
          "joined_at": "2025-08-14T19:58:00Z"
        }
      ],
      "applications": [
       {
         "id": "v111d4af8cd74272a284831fbae14a8v",
          "cluster": 1,
          "type": 1,
          "name": "Simple API",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "language": "nodejs",
          "ram": 128,
          "status": "up",
          "subdomain": null,
          "custom_domain": null,
          "last_commit": "2025-08-09T15:51:47.234Z",
          "last_backup": null,
          "created_at": "2025-08-09T15:51:47.234Z",
          "updated_at": "2025-08-11T15:06:41.449Z"
       }
      ],
      "databases": [
        {
          "id": "639d9aa35d8b4e559bcd066db4ddcc8c",
          "cluster": 1,
          "type": 3,
          "name": "MyDatabase",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "status": "up",
          "storage": 512,
          "ram": 256,
          "host": "vertra-cloud-redis-639d9aa35d8b4e559bcd066db4ddcc8c.db.vertraweb.app",
          "port": 6379,
          "duration": 30,
          "expires_at": "2025-09-14T19:58:00Z",
          "plan_id": 1,
          "purchased_at": "2025-08-14T19:58:00Z",
          "last_backup": "2025-08-14T19:58:00Z",
          "created_at": "2025-08-14T19:58:00Z",
          "updated_at": "2025-08-14T19:58:00Z"
        }
      ],
      "created_at": "2025-08-14T19:58:00Z",
      "updated_at": "2025-08-14T19:58:00Z"
    }
  ]
}

GET

organizations

all

{id}

Get User Organizations

curl --request GET \
  --url https://api.vertracloud.app/v1/organizations/all/{id} \
  --header 'Authorization: Bearer <token>'

{
  "status": "success",
  "response": [
    {
      "id": "org123",
      "name": "myorganization",
      "description": "I have a description :)",
      "tags": ["discord", "programming"],
      "owner_id": "993591427428790342",
      "plan_id": 1,
      "members": [
        {
          "user_id": "993591427428790342",
          "role": "owner",
          "joined_at": "2025-08-14T19:58:00Z"
        }
      ],
      "applications": [
       {
         "id": "v111d4af8cd74272a284831fbae14a8v",
          "cluster": 1,
          "type": 1,
          "name": "Simple API",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "language": "nodejs",
          "ram": 128,
          "status": "up",
          "subdomain": null,
          "custom_domain": null,
          "last_commit": "2025-08-09T15:51:47.234Z",
          "last_backup": null,
          "created_at": "2025-08-09T15:51:47.234Z",
          "updated_at": "2025-08-11T15:06:41.449Z"
       }
      ],
      "databases": [
        {
          "id": "639d9aa35d8b4e559bcd066db4ddcc8c",
          "cluster": 1,
          "type": 3,
          "name": "MyDatabase",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "status": "up",
          "storage": 512,
          "ram": 256,
          "host": "vertra-cloud-redis-639d9aa35d8b4e559bcd066db4ddcc8c.db.vertraweb.app",
          "port": 6379,
          "duration": 30,
          "expires_at": "2025-09-14T19:58:00Z",
          "plan_id": 1,
          "purchased_at": "2025-08-14T19:58:00Z",
          "last_backup": "2025-08-14T19:58:00Z",
          "created_at": "2025-08-14T19:58:00Z",
          "updated_at": "2025-08-14T19:58:00Z"
        }
      ],
      "created_at": "2025-08-14T19:58:00Z",
      "updated_at": "2025-08-14T19:58:00Z"
    }
  ]
}

string

required

The ID of the user whose organizations are to be retrieved. Use @me to refer to the authenticated user.

Response

status

string

Indicates whether the call was successful. success if successful, error if not.

response

array

An array of organization objects.

Show Toggle object

string

The ID of the organization.

name

string

The name of the organization.

description

string

The description of the organization.

tags

array

The tags associated with the organization.

owner_id

string

The ID of the organization owner.

plan_id

number

The ID of the owner’s plan.

members

array

An array of member objects.

Show Toggle object

user_id

string

The ID of the member.

role

string

The role of the member (e.g., owner, admin, developer, operator, viewer).

joined_at

string

The timestamp when the member joined the organization.

applications

array

An array of application objects associated with the organization.

Show Toggle object

string

The ID of the application.

owner_id

string

The ID of the application owner.

owner_plan_id

number

The ID of the owner’s plan.

type

number

The type of the application.

status

string

The status of the application (e.g., up).

cluster

number

The cluster ID where the application is hosted.

language

number

The programming language of the application.

subdomain

string

The subdomain of the application.

custom_domain

string | null

The custom domain of the application, if set.

created_at

string

The timestamp when the application was created.

updated_at

string

The timestamp when the application was last updated.

last_commit

string

The timestamp of the last commit.

last_backup

string | null

The timestamp of the last backup, if available.

databases

array

An array of database objects associated with the organization.

Show Toggle object

string

The ID of the database.

owner_id

string

The ID of the database owner.

owner_plan_id

number

The ID of the owner’s plan.

type

number

The type of the database.

cluster

number

The cluster ID where the database is hosted.

status

string

The status of the database (e.g., up).

plan_id

number

The ID of the database plan.

host

string

The host address of the database.

port

number

The port used by the database.

created_at

string

The timestamp when the database was created.

updated_at

string

The timestamp when the database was last updated.

purchased_at

string

The timestamp when the database was purchased.

expires_at

string

The timestamp when the database subscription expires.

last_backup

string | null

The timestamp of the last backup, if available.

created_at

string

The timestamp when the organization was created.

updated_at

string

The timestamp when the organization was last updated.

{
  "status": "success",
  "response": [
    {
      "id": "org123",
      "name": "myorganization",
      "description": "I have a description :)",
      "tags": ["discord", "programming"],
      "owner_id": "993591427428790342",
      "plan_id": 1,
      "members": [
        {
          "user_id": "993591427428790342",
          "role": "owner",
          "joined_at": "2025-08-14T19:58:00Z"
        }
      ],
      "applications": [
       {
         "id": "v111d4af8cd74272a284831fbae14a8v",
          "cluster": 1,
          "type": 1,
          "name": "Simple API",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "language": "nodejs",
          "ram": 128,
          "status": "up",
          "subdomain": null,
          "custom_domain": null,
          "last_commit": "2025-08-09T15:51:47.234Z",
          "last_backup": null,
          "created_at": "2025-08-09T15:51:47.234Z",
          "updated_at": "2025-08-11T15:06:41.449Z"
       }
      ],
      "databases": [
        {
          "id": "639d9aa35d8b4e559bcd066db4ddcc8c",
          "cluster": 1,
          "type": 3,
          "name": "MyDatabase",
          "description": "I have a description :)",
          "owner_id": "993591427428790342",
          "owner_plan_id": 1,
          "status": "up",
          "storage": 512,
          "ram": 256,
          "host": "vertra-cloud-redis-639d9aa35d8b4e559bcd066db4ddcc8c.db.vertraweb.app",
          "port": 6379,
          "duration": 30,
          "expires_at": "2025-09-14T19:58:00Z",
          "plan_id": 1,
          "purchased_at": "2025-08-14T19:58:00Z",
          "last_backup": "2025-08-14T19:58:00Z",
          "created_at": "2025-08-14T19:58:00Z",
          "updated_at": "2025-08-14T19:58:00Z"
        }
      ],
      "created_at": "2025-08-14T19:58:00Z",
      "updated_at": "2025-08-14T19:58:00Z"
    }
  ]
}

Error Responses

status

string

Indicates whether the call was successful. error if not successful.

code

string

The error code indicating the reason for failure. Possible values:

UNAUTHORIZED: The user is not authenticated.
USER_NOT_FOUND: The specified user does not exist.
ID_MUST_BE_A_STRING: The provided user ID is not a string.

{
  "status": "error",
  "code": "USER_NOT_FOUND"
}

Organization Delete Organization

API Documentation

API Reference

Get User Organizations

Response

Error Responses

API Documentation

API Reference

​Response

​Error Responses

Response

Error Responses