This endpoint allows you to generate random passwords. To access the /password endpoint, you will need to provide the proper authentication using the Authorization header.

Endpoint Details

The /password endpoint allows you to retrieve information about a specific password.

  • URL: /password
  • Method: GET
  • Content Type: application/json


To make requests to the /password endpoint, you must include an Authorization header in your API calls. This header should contain a valid access token.

Example Authorization Header

Authorization: YOUR_ACCESS_TOKEN

Replace YOUR_ACCESS_TOKEN with the actual token provided to you.



The request to the /password endpoint should be a JSON object with the following headers:

AuthorizationstringThe unique identifier of the user sending the request.True


The request parameters for the /password endpoint.

charLengthnumber(Optional) The desired length of the generated password. If not provided, a default length is used.False

Example Request

Here's an example of how to make a request to the /password endpoint.

import axios from "axios";
Replace "YOUR_ACCESS_TOKEN" with the token you got from the Kohai Bot and the endpoint.
const url = "https://waifu.it/api/v4/password";
const charLength = 12; // Replace with your desired password length (optional).
const data = async () => {
  try {
    const { data } = await axios.get(url, { 
      headers: {
        Authorization: "YOUR_ACCESS_TOKEN",
      params: {
        charLength: charLength || undefined,
    return data;
  } catch (err) {
    throw new Error(err.message);

Remember to replace YOUR_ACCESS_TOKEN with your actual access token.


The server will respond with an appropriate message based on the input provided. A successfully API request will respond with a JSON object containing the following information:

  • password: The unique password that is generated for you.
  • status: Response status

Content Type: application/json

  "password": "&CbO891uM7G3"
  "status": 200,

This documentation should help you use axios (opens in a new tab) for Node.js and requests (opens in a new tab) for Python to interact with the /password endpoint.