/ByHireDate

Get Users by Hire Date

Returns a list of users based on their hire date.

Request

• URL

  /api/v1/roster/users/byhiredate

• Method

  GET

• Query Parameters

  • hire_date: The hire date 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 hire date."
    }

  OR

  • Code: 404 Not Found

  • Content:

    {
        "error": "No users are correlated with that hire date."
    }

• Sample Call

  GET https://api.arma.origin-development.net/api/v1/roster/users/byhiredate?hire_date=YYYY-MM-DD

Notes

• This endpoint retrieves users based on their hire date.

• The hire date is required as a query parameter in the format YYYY-MM-DD.

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