member.status

GET · batch ≤ 50 · api v1

The member's status in one قطاع: active, on vacation, resigned, terminated, retired, or not a member. Up to 50 members in one call.

حالة العضو في قطاع: نشط، في إجازة، مستقيل، مفصول، متقاعد، أو ليس عضواً. حتى 50 عضو في طلب واحد.

Parameters

Name	Type	Required	Description
`target`	`Target`	one of	One member.
`targets`	`Target[]`	one of	Up to 50 members. Results come back in the same order.
`faction`	`string`	required	The in-game job name linked to the قطاع, e.g. "police".

Returns (`res.data`)

Name	Type	Description
`status`	`string`	active \| on_vacation \| resigned \| terminated \| retired \| not_member
`status_label`	`string`	Arabic label as shown in the dashboard.
`rank`	`table\|nil`	{ index, name }
`vacation`	`table\|nil`	{ ends_at, days_left } when on vacation.
`hiring_banned`	`boolean`	Has an active hiring ban in this قطاع.
`active_warnings`	`number`	Live warnings count.
`results`	`table[]`	Batch only: one entry per target.

Possible errors

Notes

Someone outside the قطاع gets status "not_member", not an error.
Checking many players? Pass targets instead of calling in a loop.
For a plain yes/no (armory, garage), use member.access.

Example

-- one member
local res = exports.OrcaBot_V3:Get('member.status', { target = { source = src }, faction = 'police' })

-- many members, one call
local targets = {}
for _, id in ipairs(GetPlayers()) do targets[#targets + 1] = { source = tonumber(id) } end
local all = exports.OrcaBot_V3:Get('member.status', { targets = targets, faction = 'ems' })

Example output

{
  "ok": true,
  "data": {
    "status": "on_vacation",
    "status_label": "في إجازة",
    "rank": {
      "index": 5,
      "name": "رقيب أول"
    },
    "vacation": {
      "ends_at": "2026-10-19T00:00:00Z",
      "days_left": 4
    },
    "hiring_banned": false,
    "active_warnings": 1
  },
  "meta": {
    "action": "member.status",
    "method": "GET",
    "api": 1
  }
}