/ByDiscordUsername

Get Users by Discord Username

Returns a list of users based on their Discord username.

Request

  • URL

    /api/v1/roster/users/bydiscordusername

  • Method

    GET

  • Query Parameters

    • username: The Discord username for which users are to be fetched.

Response

  • Success Response

    • Code: 200 OK

    • Content:

      {
          "user_info": {
              "discord_id": "123456789012345678",
              "discord_user": "username#1234"
          },
          "arma_data": {
              "ingame_name": "IngameName",
              "rank_name": "RankName",
              "team_name": "TeamName",
              "default_role": "DefaultRole",
              "abv": "ABV",
              "time_in_grade": "TimeInGrade",
              "ao_points": "AOPoints",
              "promotion_eligible": "PromotionEligible",
              "hire_date": "HireDate",
              "promotion_date": "PromotionDate"
          }
      }
  • Error Response

    • Code: 400 Bad Request

    • Content:

      {
          "error": "Please provide a username."
      }

    OR

    • Code: 404 Not Found

    • Content:

      {
          "error": "No users are correlated with that username."
      }
  • Sample Call

    GET https://api.arma.origin-development.net/api/v1/roster/users/bydiscordusername?username=example#1234

Notes

  • This endpoint retrieves user based on their Discord username.

  • The username is required as a query parameter.

  • If no username is provided or no users match the username, appropriate error messages are returned.

Last updated