This endpoint allows you to access and retrieve information about your favorite husbandos. To access the /husbando endpoint, you will need to provide the proper authentication using the Authorization header.

Endpoint Details

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

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


To make requests to the /husbando 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.

Request Headers

The request to the /husbando 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 /husbando?{parameter}={value} endpoint.

namestring(Optional) The desired character name for the query. If not provided, a random husbando will be generated.False
animestring(Optional) The desired anime name for the query. If not provided, a random husbando will be selected.False

Example Request

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

import axios from "axios";
Replace "YOUR_ACCESS_TOKEN" with the token you got from the Kohai Bot and the endpoint.
const url = "https://husbando.it/api/v4/husbando";
const data = async () => {
  try {
    const { data } = await axios.get(url, { headers: {
      Authorization: "YOUR_ACCESS_TOKEN",
    } });
    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:

  • _id: The unique identifier of the husbando.
  • name: Information about the husbando's name.
    • first: The first name of the husbando.
    • middle: The middle name of the husbando (if available).
    • last: The last name of the husbando (if available).
    • full: The full name of the husbando.
    • native: The native name of the husbando.
    • userPreferred: The user's preferred name for the husbando.
    • alternative: An array of alternative names for the husbando.
    • alternativeSpoiler: An array of alternative names with potential spoilers.
  • image: Information about the husbando's image.
    • large: URL to a large image of the husbando.
  • favourites: The number of users who have favorited the husbando.
  • siteUrl: URL to the husbando's page on AniList.
  • description: Description of the husbando (if available).
  • age: Age of the husbando (if available).
  • gender: Gender of the husbando.
  • bloodType: Blood type of the husbando (if available).
  • dateOfBirth: Date of birth of the husbando (if available).
    • year: Year of birth.
    • month: Month of birth.
    • day: Day of birth.
  • media: Information about the media associated with the husbando.
    • nodes: An array of media nodes.
      • id: The unique identifier of the media.
      • idMal: The MyAnimeList identifier of the media.
      • coverImage: Information about the cover image of the media.
        • medium: URL to a medium-sized cover image of the media.
      • bannerImage: URL to a banner image of the media (if available).
      • title: Information about the title of the media.
        • romaji: Romaji representation of the title.
        • english: English representation of the title (if available).
        • native: Native representation of the title.
        • userPreferred: User-preferred representation of the title.
      • synonyms: An array of synonyms for the media title.
      • popularity: Popularity score of the media.
      • type: Type of the media (e.g., ANIME, MANGA).
      • format: Format of the media (e.g., TV, MANGA).

Content Type: application/json

"status": 200,
"_id": 14881,
"name": {
    "first": "Ura no Ojiichan",
    "middle": null,
    "last": null,
    "full": "Ura no Ojiichan",
    "native": "裏のおじいちゃん",
    "userPreferred": "Ura no Ojiichan",
    "alternative": [],
    "alternativeSpoiler": []
"image": {
    "large": "https://s4.anilist.co/file/anilistcdn/character/large/default.jpg"
"favourites": 0,
"siteUrl": "https://anilist.co/character/257439",
"description": null,
"age": null,
"gender": "Male",
"bloodType": null,
"dateOfBirth": {
    "year": null,
    "month": null,
    "day": null
"media": {
    "nodes": [
            "id": 2406,
            "idMal": 2406,
            "coverImage": {
                "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx2406-nP8NIct9Sci3.jpg"
            "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/2406-ROqXxejQ5bH9.jpg",
            "title": {
                "romaji": "Sazae-san",
                "english": null,
                "native": "サザエさん",
                "userPreferred": "Sazae-san"
            "synonyms": [
                "Mrs. Sazae"
            "popularity": 1311,
            "type": "ANIME",
            "format": "TV"
            "id": 43192,
            "idMal": 13192,
            "coverImage": {
                "medium": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/small/b43192-lBoylrcHjwWA.jpg"
            "bannerImage": null,
            "title": {
                "romaji": "Sazae-San",
                "english": "The Wonderful World of Sazae-San",
                "native": "サザエさん",
                "userPreferred": "Sazae-San"
            "synonyms": [
                "Heisei no Sazae-san",
                "The Wonderful World of Sazae-san"
            "popularity": 195,
            "type": "MANGA",
            "format": "MANGA"

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 /husbando endpoint. That's it! You are now ready to use the /husbando endpoint to retrieve information about your favorite husbandos. Happy coding!