VaultCord

https://docs.vaultcord.com/
Admin
VaultCord is a Discord bot and server backup platform that protects Discord communities by backing...
Tokens:76,732
Snippets:348
Trust Score:7.2
Update:1 month ago
Show doc for...
Tokens:
Raw
### OpenAPI specification for GET /backups/scheduled

Source: https://docs.vaultcord.com/api-reference/backups/scheduled

Defines the GET /backups/scheduled endpoint that lists scheduled backups. Requires bearer authentication. Returns a 200 response with an array of backupScheduled objects, or a 401 error if the API key is invalid.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /backups/scheduled:
    get:
      tags:
        - Backups
        - Scheduled
      description: List out the backups on account
      operationId: fetchScheduledBackups
      responses:
        '200':
          $ref: '#/components/responses/backupsScheduled'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    backupsScheduled:
      description: List of future timed backups for VaultCord (scheduled in future)
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                type: array
                items:
                  $ref: '#/components/schemas/backupScheduled'
  schemas:
    backupScheduled:
      type: object
      properties:
        id:
          type: integer
          description: ID of the scheduled backup.
          example: 13381
        serverId:
          type: integer
          example: 5180
          description: VaultCord server ID.
        interval:
          type: integer
          example: 604800
          description: How often the backup runs, in seconds.
        last_run:
          type: integer
          example: 1720049460
          description: Last date of backup, in unix timestamp (seconds)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

```

--------------------------------

### OpenAPI spec for GET /backups/list

Source: https://docs.vaultcord.com/api-reference/backups/list

OpenAPI specification for the GET /backups/list endpoint. Requires bearer authentication. Returns a list of backups with key, guildName, and created_at fields. A 401 response indicates an invalid API key.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /backups/list:
    get:
      tags:
        - Backups
      description: List out the backups on account
      operationId: listBackups
      responses:
        '200':
          $ref: '#/components/responses/backups'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    backups:
      description: List of VaultCord saved backups
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                type: array
                items:
                  $ref: '#/components/schemas/backupListing'
  schemas:
    backupListing:
      type: object
      properties:
        key:
          type: integer
          description: ID of the backup.
          example: 13381
        guildName:
          type: string
          example: gcp test
          description: Name of the Discord guild backed up.
        created_at:
          type: string
          description: Creation timestamp in UTC DateTime
          example: '2024-06-30 22:50:18'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```

--------------------------------

### OpenAPI specification for GET /accounts/settings

Source: https://docs.vaultcord.com/api-reference/information/settings

OpenAPI specification for the GET /accounts/settings endpoint. Defines the request and response schemas, including the account_info schema with fields like id, email, role, expiry, twoFactorEnabled, securityKey, and created_at. The 401 response indicates an invalid API key.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /accounts/settings:
    get:
      tags:
        - Information
      description: Get information about the current account.
      operationId: getSelf
      responses:
        '200':
          $ref: '#/components/responses/account'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    account:
      description: Account settings, if this succeeds your API key is working
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                $ref: '#/components/schemas/account_info'
  schemas:
    account_info:
      type: object
      properties:
        id:
          type: integer
          example: 25204
          description: The ID of the account
        email:
          type: string
          example: google-play@vaultcord.com
          description: The email of the account
        role:
          type: string
          enum:
            - free
            - premium
            - plus
          example: plus
          description: The subscription plan of the account
        expiry:
          type: integer
          example: 1750018387
          description: The expiration of the subscription plan, in unix timestamp (seconds)
        twoFactorEnabled:
          type: string
          enum:
            - 0
            - 1
          example: 0
          description: The 2FA status of the account, 0 = OFF, 1 = ON
        securityKey:
          type: string
          enum:
            - 0
            - 1
          example: 0
          description: The WebAuthn status of the account, 0 = OFF, 1 = ON
        created_at:
          type: integer
          example: 1710529170
          description: The creation date of the account, in unix timestamp (seconds)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```

--------------------------------

### GET /stats/chart

Source: https://docs.vaultcord.com/api-reference/stats/chart

Get chart stats for member joins day-to-day, with each server representing a separate datapoint. Requires startDate and endDate query parameters.

```APIDOC
## GET /stats/chart

### Description
Get chart stats for member joins day-to-day, with each server representing a separate datapoint.

### Method
GET

### Endpoint
https://api.vaultcord.com/stats/chart

### Parameters
#### Query Parameters
- **startDate** (string, date) - Required - Start date (YYYY-MM-DD)
- **endDate** (string, date) - Required - End date (YYYY-MM-DD)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful
- **interval** (integer) - Number of days in the interval
- **startDate** (string) - Start date in ISO format
- **endDate** (string) - End date in ISO format
- **data** (array) - Daily statistics for each server
  - **day** (string, date) - Date for the statistics
  - **server_12** (integer) - Value for server ID 12
  - **server_18499** (integer) - Value for server ID 18499
  - **server_29138** (integer) - Value for server ID 29138
  - **server_38309** (integer) - Value for server ID 38309
  - **server_42016** (integer) - Value for server ID 42016
  - **server_51840** (integer) - Value for server ID 51840
- **servers** (array) - List of server IDs

#### Response Example
{
  "success": true,
  "interval": 7,
  "startDate": "2025-09-13T00:00:00.000Z",
  "endDate": "2025-09-23T00:00:00.000Z",
  "data": [
    {
      "day": "2025-09-13",
      "server_12": 0,
      "server_18499": 0,
      "server_29138": 0,
      "server_38309": 0,
      "server_42016": 0,
      "server_51840": 0
    }
  ],
  "servers": [12, 18499, 29138, 38309, 42016, 51840]
}

#### Error Response (401)
- **success** (boolean) - Indicates failure
- **message** (string) - Error message

#### Error Example
{
  "success": false,
  "message": "New login required #2"
}
```

--------------------------------

### GET /servers/{id}

Source: https://docs.vaultcord.com/api-reference/servers/settings

Fetches the settings for a specific server identified by its ID. Requires authentication via bearer token.

```APIDOC
## GET /servers/{id}

### Description
Fetch server settings.

### Method
GET

### Endpoint
/servers/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - ID of the resource

### Response
#### Success Response (200)
- **success** (boolean) - Example: true
- **data** (object) - VaultCord server settings info
  - **id** (integer) - The ID of the server
  - **accId** (integer) - The ID of the account who owns the server
  - **botId** (integer) - The ID of the custom bot linked to the server
  - **name** (string) - The name of the server
  - **guildid** (string) - Discord snowflake ID for the verified role.
  - **channelid** (string) - Discord snowflake ID for the logs channel.
  - **url** (string) - URL for the server verification page
  - **created_at** (integer) - The creation date of the server, in unix timestamp (seconds)

#### Response Example
{
  "success": true,
  "data": {
    "id": 5180,
    "accId": 25204,
    "botId": 2475,
    "name": "google play",
    "guildid": "1225834185885876296",
    "channelid": "1216840991215190148",
    "url": "mylink",
    "created_at": 1710529170
  }
}

#### Error Response (401)
- **success** (boolean) - Example: false
- **message** (string) - Example: 'New login required #2'

#### Error Response Example
{
  "success": false,
  "message": "New login required #2"
}
```

--------------------------------

### GET /servers

Source: https://docs.vaultcord.com/api-reference/servers/list

Lists all servers on the authenticated account. Returns an array of server objects with details such as ID, name, guild ID, and creation date.

```APIDOC
## GET /servers

### Description
List out the servers on account

### Method
GET

### Endpoint
https://api.vaultcord.com/servers

### Authentication
Bearer token required

### Parameters
None

### Request Example
No request body required

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array) - List of server objects.
  - **id** (integer) - ID of the server.
  - **name** (string) - Name of the server.
  - **guildid** (string) - Discord snowflake ID for the guild.
  - **created_at** (integer) - Creation date of the server in unix timestamp (seconds).

#### Response Example
{
  "success": true,
  "data": [
    {
      "id": 5180,
      "name": "google play",
      "guildid": "1218273540147646535",
      "created_at": 1710529489
    }
  ]
}

#### Error Response (401)
- **success** (boolean) - Indicates failure.
- **message** (string) - Error message.

#### Error Example
{
  "success": false,
  "message": "New login required #2"
}
```

--------------------------------

### OpenAPI specification for GET /blocklist

Source: https://docs.vaultcord.com/api-reference/blacklists/list

Defines the GET /blocklist endpoint to list blocklists. Requires bearer authentication. Returns a 200 response with a list of blocklist objects or a 401 error if the API key is invalid.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /blocklist:
    get:
      tags:
        - Blacklists
        - Blocklists
      description: List the blocklists on a VaultCord account
      operationId: listBlacks
      responses:
        '200':
          $ref: '#/components/responses/blacklists'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    blacklists:
      description: >-
        List of VaultCord firewall blocklists. Used to deny access to specific
        members
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                type: array
                items:
                  $ref: '#/components/schemas/blacklistObject'
  schemas:
    blacklistObject:
      type: object
      properties:
        id:
          type: integer
          description: Random auto-increment ID
          example: 933
        accId:
          type: integer
          example: 25204
          description: VaultCord account ID.
        userid:
          type: string
          example: '720820224877789204'
          description: Discord snowflake user ID to blocklist
        ip:
          type: string
          description: IP address to blocklist
          example: 131.247.47.171
        fingerprint:
          type: string
          description: Browser fingerprint to blocklist
          example: 1a5423084a51bd2b47fe3aedde108b0c
        region:
          type: string
          description: Region code from ip-api.com to blocklist
          example: ENG
        country:
          type: string
          description: Country code from ip-api.com to blocklist
          example: DZ
        asn:
          type: integer
          description: ASN number from ip-api.com to blocklist
          example: 13335
        created_at:
          type: string
          example: 1715282199
          description: The creation date of the blocklist, in unix timestamp (seconds)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```

--------------------------------

### GET /accounts/settings

Source: https://docs.vaultcord.com/api-reference/information/settings

Retrieves the settings and account information for the currently authenticated user. This endpoint returns details such as account ID, email, subscription plan, and security settings.

```APIDOC
## GET /accounts/settings

### Description
Get information about the current account.

### Method
GET

### Endpoint
/accounts/settings

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Account information object.
  - **id** (integer) - The ID of the account.
  - **email** (string) - The email of the account.
  - **role** (string) - The subscription plan of the account (free, premium, plus).
  - **expiry** (integer) - The expiration of the subscription plan, in unix timestamp (seconds).
  - **twoFactorEnabled** (string) - The 2FA status of the account, 0 = OFF, 1 = ON.
  - **securityKey** (string) - The WebAuthn status of the account, 0 = OFF, 1 = ON.
  - **created_at** (integer) - The creation date of the account, in unix timestamp (seconds).

#### Response Example
{
  "success": true,
  "data": {
    "id": 25204,
    "email": "google-play@vaultcord.com",
    "role": "plus",
    "expiry": 1750018387,
    "twoFactorEnabled": "0",
    "securityKey": "0",
    "created_at": 1710529170
  }
}

#### Error Response (401)
- **success** (boolean) - Indicates if the request was successful.
- **message** (string) - Error message.

#### Error Response Example
{
  "success": false,
  "message": "New login required #2"
}
```

--------------------------------

### GET /alerts

Source: https://docs.vaultcord.com/api-reference/alerts/list

Retrieves a list of alert settings for the authenticated account. This endpoint returns an array of alert objects containing details such as server name, invite code, email, and creation timestamp.

```APIDOC
## GET /alerts

### Description
List out the alerts on account

### Method
GET

### Endpoint
https://api.vaultcord.com/alerts

### Authentication
Bearer token (API key)

### Parameters
None

### Request Example
No request body required.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful. Example: `true`
- **data** (array of alertObject) - List of alert settings.

#### alertObject
- **id** (integer) - Random auto-increment ID. Example: `100`
- **accId** (integer) - VaultCord account ID. Example: `25204`
- **serverName** (string) - Name of the Discord guild. Example: `OpenAI`
- **invite** (string) - Discord invite code. Example: `openai`
- **email** (string) - Email address to send alert to. Example: `jeff@amazon.com`
- **created_at** (string) - The creation date of the alert, in unix timestamp (seconds). Example: `1715264074`

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": 100,
      "accId": 25204,
      "serverName": "OpenAI",
      "invite": "openai",
      "email": "jeff@amazon.com",
      "created_at": "1715264074"
    }
  ]
}
```

#### Error Response (401)
- **success** (boolean) - Indicates failure. Example: `false`
- **message** (string) - Error message. Example: `New login required #2`

#### Error Example
```json
{
  "success": false,
  "message": "New login required #2"
}
```
```

--------------------------------

### OpenAPI spec for GET /bots

Source: https://docs.vaultcord.com/api-reference/bots/list

OpenAPI specification for the GET /bots endpoint, which lists custom bots. Requires bearer authentication. Returns a 200 response with a botListing array or a 401 response if the API key is invalid.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /bots:
    get:
      tags:
        - Bots
      description: List out the custom bots
      operationId: listBots
      responses:
        '200':
          $ref: '#/components/responses/bots'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    bots:
      description: VaultCord bot configuration
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                type: array
                items:
                  $ref: '#/components/schemas/botListing'
  schemas:
    botListing:
      type: object
      properties:
        id:
          type: integer
          description: ID of the bot.
          example: 2475
        name:
          type: string
          example: google bot
          description: Name of the bot.
        clientId:
          type: string
          example: '1218273093298946048'
          description: Discord snowflake ID for the bot/application.
        created_at:
          type: integer
          description: The creation date of the account, in unix timestamp (seconds)
          example: 1710529389
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```

--------------------------------

### OpenAPI spec for GET /stats/dashboard

Source: https://docs.vaultcord.com/api-reference/stats/global

OpenAPI specification for the GET /stats/dashboard endpoint, which returns global stats including member counts, servers, bots, and backups. Requires bearer authentication; a 401 response indicates an invalid API key.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /stats/dashboard:
    get:
      tags:
        - Stats
        - Usercount
        - User count
      description: >-
        Get global stats for member counts from all servers, numbers of servers
        & bots.
      operationId: globalStats
      responses:
        '200':
          $ref: '#/components/responses/globalstats'
        '401':
          $ref: '#/components/responses/401'
components:
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    globalstats:
      description: Global stats
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              backups:
                type: integer
                example: 26
              bots:
                type: integer
                example: 8
              servers:
                type: integer
                example: 6
              members:
                type: integer
                example: 25389
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
```

--------------------------------

### POST /market/buy

Source: https://docs.vaultcord.com/api-reference/market/buy

Buy members from the marketplace. This endpoint allows you to place an order for members by providing the marketplace listing ID, an invite link, buyer email, and the number of members to purchase.

```APIDOC
## POST /market/buy

### Description
Buy Members

### Method
POST

### Endpoint
/market/buy

### Parameters
#### Request Body
- **marketId** (integer) - Required - The marketplace listing ID. You can get this by listing sellers or viewing https://vaultcord.com/market?developers=1
- **inviteLink** (string) - Required - Send the Discord.gg invite link we should deliver members to
- **userEmail** (string) - Required - Buyer email. You SHOULD send a unique email every time because we will show errors if a buyer attempts to buy same members twice.
- **amount** (integer) - Required - The number of members being purchased.
- **budget** (integer) - Optional - Limit the total cost of the order (since we've been told some sellers are naughty and raise prices suddenly) in cents. For example if you want the whole order to cost less than $20, then it will show as 2000

### Request Example
{
  "marketId": 618,
  "inviteLink": "dyno",
  "userEmail": "william@nelsoncybersecurity.com",
  "amount": 100,
  "budget": 2000
}

### Response
#### Success Response (200)
- **success** (boolean) - Description
- **data** (object) - Description

#### Response Example
{
  "success": true,
  "data": {
    "newBalance": 550,
    "url": "https://example.com"
  }
}

#### Error Response (402)
- **success** (boolean) - Description
- **message** (string) - Description

#### Error Response Example
{
  "success": false,
  "message": "Your balance is zero. Please top up balance on dashboard."
}
```

--------------------------------

### GET /market/fetch

Source: https://docs.vaultcord.com/api-reference/market/fetch

Fetches the list of sellers on the member marketplace. Data is cached for 2 hours, use webhooks on https://dash.vaultcord.com/developers for instant notifications when new sellers added.

```APIDOC
## GET /market/fetch

### Description
Fetch list of sellers on the member marketplace. Data is cached for 2 hours, use webhooks on https://dash.vaultcord.com/developers for instant notifications when new sellers added.

### Method
GET

### Endpoint
https://api.vaultcord.com/market/fetch

### Parameters
#### Query Parameters
- **filter** (string) - Optional - Filter to apply to the market results. Defaults to no filtering if not provided. Allowed values: price-low, price-high, newest, most-members.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array) - List of market sellers. Each item contains:
  - **serverName** (string) - VaultCord server name the seller's members come from.
  - **title** (string) - Product title.
  - **cost** (integer) - Cost of the members (per 100, not individually) in cents. For example if it costs $2.25 per 100 members, then it will show as 225.
  - **numOrders** (integer) - Number of orders this seller has.
  - **category** (string) - The category of the community the members belong to.
  - **minAmount** (integer) - Number of members you must buy or it won't allow to be purchased. It will be 0 if no minimum.

#### Response Example
{
  "success": true,
  "data": [
    {
      "serverName": "The Nexam Hub",
      "title": "old rich guys in this server they will buy anything",
      "cost": 225,
      "numOrders": 850,
      "category": "gaming",
      "minAmount": 300
    }
  ]
}

#### Error Response (401)
- **success** (boolean) - Indicates if the request was successful.
- **message** (string) - Error message.

#### Error Example
{
  "success": false,
  "message": "New login required #2"
}

### Authentication
Requires bearer token authentication.
```

--------------------------------

### OpenAPI spec for GET /market/fetch

Source: https://docs.vaultcord.com/api-reference/market/fetch

OpenAPI specification for the GET /market/fetch endpoint. It defines the request parameters, response schemas, and security scheme. The endpoint returns a list of marketplace sellers, with optional filter query parameter and caching behavior.

```yaml
openapi: 3.0.0
info:
  description: VaultCord public API for developers to access resources
  version: 1.0.0
  title: VaultCord Developers API
  x-logo:
    url: https://cdn.vaultcord.com/logo.png
    backgroundColor: '#FFFFFF'
    altText: VaultCord logo
    href: https://vaultcord.com
servers:
  - description: VaultCord Developers API endpoint
    url: https://api.vaultcord.com
security:
  - bearerAuth: []
tags:
  - name: Servers
    description: Servers endpoints
  - name: Bots
    description: Bot endpoints
  - name: Backups
    description: Backup endpoints
  - name: Members
    description: Member endpoints
  - name: Alerts
    description: Alert endpoints
  - name: Whites
    description: Whitelist endpoints
  - name: Core
    description: Core endpoints
  - name: Account
    description: Account endpoints
  - name: Recovery
    description: Recovery endpoints
  - name: Webhook
    description: Webhook endpoints
  - name: Stat
    description: Stat endpoints
  - name: Developer
    description: Developer endpoints
  - name: Discord
    description: Discord endpoints
  - name: Team
    description: Team endpoints
  - name: Market
    description: Market endpoints
  - name: Sitegpt
    description: Sitegpt endpoints
  - name: Black
    description: Black endpoints
  - name: Payment
    description: Payment endpoints
  - name: Donate
    description: Donate endpoints
  - name: Lootlabs
    description: Lootlabs endpoints
  - name: Advertise
    description: Advertise endpoints
  - name: Admin
    description: Admin endpoints
paths:
  /market/fetch:
    get:
      tags:
        - Market
        - Marketplace
        - Buy members
      description: >-
        Fetch list of sellers on the member marketplace. Data is cached for 2
        hours, use webhooks on https://dash.vaultcord.com/developers for instant
        notifications when new sellers added.
      operationId: fetchMarketplace
      parameters:
        - $ref: '#/components/parameters/marketFilter'
      responses:
        '200':
          $ref: '#/components/responses/marketFetched'
        '401':
          $ref: '#/components/responses/401'
components:
  parameters:
    marketFilter:
      in: query
      name: filter
      schema:
        type: string
        enum:
          - price-low
          - price-high
          - newest
          - most-members
      required: false
      description: >-
        Filter to apply to the market results. Defaults to no filtering if not
        provided.
  responses:
    '401':
      description: >-
        API key invalid, please generate a new one from
        dash.vaultcord.com/developers
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
                example: 'New login required #2'
    marketFetched:
      description: >-
        List of member marketplace sellers. This data is saved for 30 minutes
        for quicker response time.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: true
              data:
                type: array
                items:
                  $ref: '#/components/schemas/marketFetchObject'
  schemas:
    marketFetchObject:
      type: object
      properties:
        serverName:
          type: string
          example: The Nexam Hub
          description: VaultCord server name the seller's members come from
        title:
          type: string
          description: Product title
          example: old rich guys in this server they will buy anything
        cost:
          type: integer
          description: >-
            Cost of the members (per 100, not individually) in cents. For
            example if it costs $2.25 per 100 members, then it will show as 225
          example: 225
        numOrders:
          type: integer
          description: Number of orders this seller has
          example: 850
        category:
          type: string
          description: The category of the community the members belong to
          example: gaming
        minAmount:
          type: integer
          description: >-
            Number of members you must buy or it won't allow to be purchased. It
            will be 0 if no minimum.
          example: 300
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

```
Tokens:
Raw