مرجع الـ API و MCP

GET /api/v1/app/brand (docs/mobile-app.md, "أيقونة التطبيق"): the main brand from the admin panel, for the app's build script (icon, splash) and its screens. Public and cacheable. The icon sources fall back to the mark; `version` changes whenever any of it does. data: name, colors {brand, accent}, logo_url, logo_white_url, mark_url, mark_white_url, icon_url, icon_white_url, icon_source (app_icon|mark), version.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

120 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/brand" \
  -H "Accept: application/json"

What the mobile app is painted with before anyone signs in: the system palette and logos from the admin panel.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/branding" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/help/categories" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/help/articles?q=...&category=getting-started" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/help/articles/{category}/{article}" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

120 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/meta" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/password/options" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/password/forgot" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","channel":"..."}'

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/password/reset" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"...","password":"..."}'

GET /api/v1/app/server-switch (docs/mobile-server-switch.md): only whether the app's live/dev switch works now, nothing else. Public, never cached: the app asks at the moment of the 15th tap, and on dev at every open.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/server-switch" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/site/contact/options" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

curl -X POST "https://api.mihnaro.com/api/v1/site/contact" \
  -H "Accept: application/json"

The mobile app after single sign-on (MobileSso): the one-time code and its PKCE code_verifier. No 2FA code: the provider checked.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/sso/token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"code":"...","code_verifier":"...","device_name":"...","device_id":"..."}'

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"...","password":"...","device_name":"...","code":"...","device_id":"..."}'

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/tools/calculators" \
  -H "Accept: application/json"

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/tools/calculators/{tool}" \
  -H "Accept: application/json"

Every country with rules: the tools each can run, its variants and how many of its rules are verified.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/tools/countries" \
  -H "Accept: application/json"

A country's rules in force, with each rule's source and verified mark; a country with none says so.

الدخول

لا شيء

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/tools/countries/{country}" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/time-zones" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/time-zones" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"device_tz_id":1,"schedule":[],"holidays_closed":true,"branch_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/time-zones/{zone}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"device_tz_id":1,"schedule":[],"holidays_closed":true,"branch_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/levels" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/levels" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"access_time_zone_id":1,"doors":[],"branch_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/levels/{level}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"access_time_zone_id":1,"doors":[],"branch_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/assignments" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/assignments" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"access_level_id":1,"target_type":"employee","effect":"allow","target_id":1,"biometric_device_id":1,"visitor_name":"...","visitor_pin":"...","visitor_card":"...","starts_at":"2026-11-01","ends_at":"2026-11-01","note":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/assignments/{assignment}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"access_level_id":1,"target_type":"employee","effect":"allow","target_id":1,"biometric_device_id":1,"visitor_name":"...","visitor_pin":"...","visitor_card":"...","starts_at":"2026-11-01","ends_at":"2026-11-01","note":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

devices.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/access/{kind}/{id}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

20 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/test" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/refresh" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

The ledger's accounts, analytics, partners and journals as last read.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/catalog" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

OAuth 2 (QuickBooks, Xero): the consent link to open in a browser signed in to Mihnaro as the same person.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/oauth-url" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/mappings" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

PUT items: [{type, local_key, external_id}]; auto_match: true maps accounts whose codes match.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/mappings" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/preview?run_id=1" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/post" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"run_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting/{provider}/sync-employees" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"employee_ids":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting-postings" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting-postings/{posting}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.manage.*

حد الطلبات

30 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/accounting-postings/{posting}/{action}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET activity-log?tab=changes|requests|sign_ins plus the tab's filters

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

activity.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/activity-log" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"apply_changes":"update","balance_date":"2026-11-01","name_ar":"...","name_en":"...","tickets":1.5,"period_months":1,"period_anchor":"hire","accrual":"period_start","amount":1.5,"family_members":1,"eligible_after_months":1,"applies_to":"all","expire_option":"after","expire_after_months":1,"distribution":"per_person","default_payroll":"in_payroll","default_request_type":"cash_out","transaction_type_id":"...","gl_identifier":"...","clearance_account":"...","setups":[]}'

The policy and the employees in my payroll.manage scope it was given to, with their opening balance.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies/{policy}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies/{policy}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"apply_changes":"update","balance_date":"2026-11-01","name_ar":"...","name_en":"...","tickets":1.5,"period_months":1,"period_anchor":"hire","accrual":"period_start","amount":1.5,"family_members":1,"eligible_after_months":1,"applies_to":"all","expire_option":"after","expire_after_months":1,"distribution":"per_person","default_payroll":"in_payroll","default_request_type":"cash_out","transaction_type_id":"...","gl_identifier":"...","clearance_account":"...","setups":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies/{policy}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

scope all | selected (employee_ids[]), opening_balance.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies/{policy}/assign" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"scope":"all","employee_ids":[],"opening_balance":1.5}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-ticket-policies/{policy}/employees/{employee}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Transactions in my scope with the screen's filters (employee_id, policy, status, payment, payroll, request_status, from, to, paid_from, paid_to, resident_id).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.view

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Every active employee's balance in my scope under each of their policies (policy filters one).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.view

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets/balances" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"employee_id":1,"policy_id":1,"slice":1,"tickets":[],"owners":[],"cash_out":true,"amount":1.5,"destination":"...","travel_date":"2026-11-01","return_date":"2026-11-01","notes":"..."}'

ids[], paid_at, payment_reference: booked (not cash out) unpaid ones are marked.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets/paid" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"ids":[],"paid_at":"2026-11-01","payment_reference":"..."}'

ids[]: the unpaid ones are deleted; returns how many.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets/bulk-delete" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"ids":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

payroll.air_tickets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/air-tickets/{transaction}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

q: search; show; per_page. Only those the person may read (their targets; all with announcements.manage).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.announcements | announcements.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.announcements | announcements.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/{announcement}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Marks one the person may read as read (their bell notice of it), as opening it on the screen does.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.announcements | announcements.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/{announcement}/read" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

A picture of the company's announcements (their text and galleries).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.announcements | announcements.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/images/{file}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

An attached file of an announcement the person may read (copied from ZenHR or added in Mihnaro).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.announcements | announcements.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/{announcement}/attachments/{index}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Multipart: file, kind (image: for the text or the gallery; file: an attachment). Returns the file to save with.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

announcements.create | announcements.edit

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/media" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

title {en, ar}, body {en, ar}, pinned, starts_on, expires_on, gallery, attachments, targets (Announcements::save). The people it is for are notified.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

announcements.create

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"title":{"en":"...","ar":"..."},"body":{"en":"...","ar":"..."},"starts_on":"2026-11-01","expires_on":"2026-11-01"}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

announcements.edit

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/{announcement}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

announcements.delete

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/announcements/{announcement}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.api_keys.manage

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/api-keys" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

POST api-keys: the token is in the answer this once.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.api_keys.manage

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/api-keys" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"...","abilities":[],"ip_addresses":"...","expires_on":"2026-11-01","user_id":1,"auth_type":"basic","consumer_key":"...","consumer_secret":"...","realm":"...","client_id":"...","client_secret":"...","username":"...","password":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.api_keys.manage

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/api-keys/{apiKey}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"...","abilities":[],"ip_addresses":"...","expires_on":"2026-11-01","user_id":1,"auth_type":"basic","consumer_key":"...","consumer_secret":"...","realm":"...","client_id":"...","client_secret":"...","username":"...","password":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

integrations.api_keys.manage

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/api-keys/{apiKey}/revoke" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-activity: the sign-in activity of the people in the app_devices.view scope (filters: user_id, install_id, device_id, event, result, from, to).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-activity" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices: the phones of the people in the app_devices.view scope, with the summary (docs/platform-control.md).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices/people/{user}: one person's phones with their IPs and timelines (the person themselves, or app_devices.view in scope).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

أي مستخدم مسجّل في الشركة

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/people/{user}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices/people/{user}/context (app_devices.context, docs/platform-control.md «بيانات الهاتف»): the phone details this company's switches collected for a person in scope, latest per phone and the history.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.context

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/people/{user}/context" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

POST app-devices/phones/{install}/test-push (app_devices.test_push, docs/notifications.md «الإشعار التجريبي»): what Apple or Google answered.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.test_push

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/phones/{install}/test-push" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices/shared: the phones in scope used by more than one account (the fleet filters too).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/shared" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices/allowances (?phone_key=, ?active=1): HR's exceptions for the people in scope.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/allowances" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

POST app-devices/allowances: user_id, install_id (or phone_key), reason.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.allow_shared

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/allowances" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"user_id":1,"install_id":1,"phone_key":"...","reason":"..."}'

DELETE app-devices/allowances/{id}: takes the exception back.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.allow_shared

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/allowances/{allowance}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET app-devices/not-on-app: q, branch_id, account (yes|no); page, per_page.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.view

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/not-on-app" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

POST app-devices/reminders: channel (email|whatsapp), employee_ids[] or all=true (with filters {q, branch_id, account}).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

app_devices.remind

حد الطلبات

10 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-devices/reminders" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"channel":"email","all":true,"employee_ids":[],"filters":[],"q":"...","branch_id":1,"account":"yes"}'

Every mobile app rule for the signed-in employee: {live_location, app_lock, punch_auth} (docs/live-location.md).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

أي مستخدم مسجّل في الشركة

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-policy" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

The app saw a screenshot (iOS can't stop one, only black it out) or a screen recording start while it blocks them. Nothing is stored here: the activity log keeps the request (route app-policy.screen-captures, the kind in the path).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

أي مستخدم مسجّل في الشركة

الوحدة

hrm

حد الطلبات

30 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/app-policy/screen-captures/{kind}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

chain_<kind> per kind: a CHAINS value, "tpl:<id>", or "none" (salary batches).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PUT "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-chains" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Approval chains of each request kind ('' = the kind's default), and the approval templates.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-setup" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

GET approval-setup/approvers: who "Approved By" can name for a template (template_id) or a new one, from its own branch only.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-setup/approvers" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-templates" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"object_type":"leave","object_id":1,"assign":[],"steps":[],"skip_after":1,"skip_after_unit":"days","notify_user_ids":[],"overrider_ids":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-templates/{template}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

approval_setup.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approval-templates/{template}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

The approvals page: tab (approvals, my, team, override), status, type. Leave requests and employee requests together.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.approvals.decide | requests.view | requests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals?tab=...&status=all&type=...&my_action=waiting" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Override approvals: decide a request waiting on someone else. item is "leave:ID" or "request:ID".

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

أي مستخدم مسجّل في الشركة

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals/override" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"item":"...","decision":"approved","decision_note":"..."}'

Approve or reject several items; the ones that can't be decided are skipped.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.approvals.decide | requests.view | requests.manage

الوحدة

hrm

حد الطلبات

30 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals/bulk" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"items":[],"decision":"approved","decision_note":"..."}'

Approval delegations I gave or received (ZenHR's "Delegated").

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.approvals.delegate | requests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals/delegations" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Delegate my approvals: delegate_id (a user of the company), starts_on, ends_on (empty = until ended), note.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.approvals.delegate | requests.manage

الوحدة

hrm

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals/delegations" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"delegate_id":1,"starts_on":"2026-11-01","ends_on":"2026-11-01","note":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.approvals.delegate | requests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/approvals/delegations/{delegation}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/summary" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Attempts waiting for a person, with the answers to grade.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/grading" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

An attempt with every answer, the right ones and the anti-cheating log.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/attempts/{attempt}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

points (0 to the question's points), note; reason when changing a grade already given (an automatic one too).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/answers/{answer}/grade" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"points":1.5,"note":"...","reason":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/answers/{answer}/media" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Every attempt with its score and checks, and how each question did.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}/results" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}/export" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Filters: test, status, candidate, employee.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.grade

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/invitations" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/templates" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/templates/{key}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/categories" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

name {en, ar}, description {en, ar}, competency_id.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/categories" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"description":{"en":"...","ar":"..."},"competency_id":1}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/categories/{category}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/categories/{category}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Filters: category, type, difficulty, active, q.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions/{question}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions/{question}/media" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

type, assessment_category_id, difficulty, prompt {en, ar}, options [{key?, text {en, ar}}], targets, answer, points, time_limit_seconds, explanation, is_active.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"type":"single","assessment_category_id":1,"difficulty":"easy","prompt":{"en":"...","ar":"..."},"explanation":{"en":"...","ar":"..."},"points":1.5,"time_limit_seconds":1,"is_active":true,"options":[],"targets":[],"answer":"...","correct":"...","remove_media":true}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions/{question}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.questions.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/questions/{question}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Filters: status, purpose, q.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.*

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

A test with its items.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.*

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

title, description, instructions ({en, ar}), purpose, time_limit_minutes, shuffle_questions, shuffle_options, attempts_allowed, pass_mark, negative_marking, negative_ratio, show_score, competency_id, pass_stage, fail_stage, status, items.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.tests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"title":{"en":"...","ar":"..."},"description":{"en":"...","ar":"..."},"instructions":{"en":"...","ar":"..."},"purpose":"pre_employment","time_limit_minutes":1,"shuffle_questions":true,"shuffle_options":true,"negative_marking":true,"show_score":true,"attempts_allowed":1,"pass_mark":1.5,"negative_ratio":1.5,"competency_id":1,"pass_stage":"...","fail_stage":"...","status":"draft","items":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.tests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.tests.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

candidate_ids, employee_ids, expires_at, locale. The candidates' links are in the answer.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.invite

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/tests/{test}/invitations" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"candidate_ids":[],"employee_ids":[],"expires_at":"2026-11-01","locale":"en","pass_stage":"...","fail_stage":"..."}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.invite

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/invitations/{invitation}/cancel" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

expires_at (optional; required when the link has expired). sent and reason (sandbox, mail_off, employees_held, no_email, failed) say what happened.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assessments.manage.* | assessments.invite

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assessments/invitations/{invitation}/resend" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"expires_at":"2026-11-01"}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/asset-types" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

name {en, ar}, branch_ids (ids, or ["all"]), active.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/asset-types" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"branch_ids":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/asset-types/{assetType}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":{"en":"...","ar":"..."},"branch_ids":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/asset-types/{assetType}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

The list: status, type, owner (branch id or none), holder, expiry_from, expiry_to, q.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage | assets.create | assets.edit | assets.delete | assets.assign | assets.status

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.create

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"asset_type_id":1,"name":"...","serial_number":"...","owner_branch_id":1,"purchase_date":"2026-11-01","value":1.5,"notes":"...","description":"...","owner":"...","production_date":"2026-11-01","expiry_date":"2026-11-01","attachments":[]}'

An asset and its history.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.manage | assets.create | assets.edit | assets.delete | assets.assign | assets.status

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.edit

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X PATCH "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"asset_type_id":1,"name":"...","serial_number":"...","owner_branch_id":1,"purchase_date":"2026-11-01","value":1.5,"notes":"...","description":"...","owner":"...","production_date":"2026-11-01","expiry_date":"2026-11-01","attachments":[]}'

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.delete

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X DELETE "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

Hand it to an employee in scope: assigned_to, assigned_at, return_date, notes, attachments[].

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.assign

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}/assign" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"assigned_to":1,"assigned_at":"2026-11-01","return_date":"2026-11-01","notes":"...","attachments":[]}'

Take it back: it becomes available.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.assign

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}/release" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

status: damaged, under_repair, archived or available.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

assets.status

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/assets/{asset}/status" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.clock

الوحدة

hrm

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/clock-in" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -F "attendance_function_id=1" \
  -F "[email protected]"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.clock

الوحدة

hrm

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/clock-out" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -F "[email protected]"

Scanning a work location's QR code (the mobile app reads the code's link /clock/qr/{token}?t=&s=): clocks out if a shift is open, otherwise in, with the same checks as the link. token, t and s from the code.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

self.clock

الوحدة

hrm

حد الطلبات

20 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/scan" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"...","t":1,"s":"...","attendance_function_id":1}'

The punch log: employee, branch, from, to, channel, device, ip, flagged, status, review; format=csv|xlsx for the branded export.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

attendance.security.review

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/punch-log?from=2026-11-01&to=2026-11-01&employee=1&branch=1" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

attendance.security.review

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/punch-log/{context}" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

decision: approve or reject; note; approve_device to approve its pending device too.

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

attendance.security.review

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl -X POST "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/punch-log/{context}/decide" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"decision":"approve","note":"...","approve_device":true}'

The team's month: totals per employee in reach (attendance.view).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

attendance.view

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة

curl "https://api.mihnaro.com/api/v1/app/companies/$MIHNARO_COMPANY/attendance/team" \
  -H "Authorization: Bearer $MIHNARO_TOKEN" \
  -H "Accept: application/json"

One day of the team (docs/mobile-hrm.md): date (today by default).

الدخول

رمز دخول أو مفتاح API للشركة

الصلاحية

attendance.view

الوحدة

hrm

حد الطلبات

60 طلباً في الدقيقة