Gofive OpenAPI
empeo
VenioeTaxGo
empeo
VenioeTaxGo
  1. Recruitment
  • Authentication
    • Authorization
      POST
  • Master
    • Get Organizations
      GET
    • Get CustomField
      GET
    • Get Holiday
      GET
    • Get MasterSetup
      GET
    • Get Master Items
      GET
    • Get Overtimes
      GET
  • Recruitment
    • Add Recruitments
      POST
    • Get Candidate
      GET
    • Get Positions
      GET
  • Core HR
    • Attendance
      • Get Time Attendance
      • Workin
      • Get Employee WorkIn Site
      • Get Timestamps
      • Get TimeStamp Attachments
      • Get Workin Sites
      • Get IOMO Logs
      • Add Timestamps
      • Get Pulse Survey
    • Asset
      • Get Asset list
      • Update Asset
      • Get Employee Assets
    • Employee
      • Get Employee
      • Update Employee
      • Get Employees List
      • Get Mastertypes List
      • Get Name Prefixes
      • Get Document Types
      • Update Employee
      • Add Employee Attachment
      • Update Employee Address
      • Update Employee Family
      • Update Employee Contact
      • Update Employee Education
      • Update Employee Experience
      • Update Employee CustomField
      • Delete Employee
      • Get Employee Role
      • Get Employee Movement Lists
    • Leave
      • Get Employee Documents
    • Shifts
      • Get Shift Details
      • Update Employee Shifts
      • Get Employee Shifts
      • Swap Employee Shifts
    • Timesheet
      • Search Projects
      • Search Tasks
      • Create Timesheet Entry
  • Payroll
    • Get Financial Transactions
      POST
    • Update Financial Transactions
      PUT
    • Create Loan
      POST
    • Get Cost Center
      POST
  • Welfare
    • Shuttle Buses
      GET
    • Passengers
      GET
  • Goals
    • Update KPI
      POST
  • Engagement
    • Achievement
      • Get Employee Achievements
      • Create Achievement Card
      • Create Achievement Award Document
      • Get Achievement Events
    • Praise
      • Get Employee Praises
      • Get Praise Types
      • Create Praise Reward Manager
    • StampCard
      • Get Stamp Cards
      • Get Stamp Card Detail
      • Add Stamp
    • Celebration
      • Get Upcoming Celebrations
    • Mission
      • ดึงคิวงานรอตรวจ
      • ดึงรายละเอียดงาน 1 ใบ
      • ดึงตัวเลขสรุปงานตามสถานะ
      • อนุมัติงานหลายใบพร้อมกัน
      • ส่งงานกลับให้แก้หลายใบพร้อมกัน
  • Overtime
    • Get Overtimes Preriods
    • Get Overtimes Documents
  • Employee
    • User Info
    • Update Employee Information
  1. Recruitment

Get Positions

GET
https://api.gofive.co.thempeo/api/v1/positions
ดึงตำแหน่งงานของ tenant ที่ token ผูกอยู่ พร้อมการตั้งค่าทุกหมวดของตำแหน่ง ทุก parameter ไม่บังคับ —
ไม่ส่งเลยหมายถึงเอาทุกตำแหน่ง (หน้าแรก 20 รายการ)
🎛️ ค่าเริ่มต้นและตัวกรอง
name ค้นบางส่วนของชื่อตำแหน่งทั้งชื่อไทยและชื่ออังกฤษ ไม่สนตัวพิมพ์เล็ก-ใหญ่ และตัดช่องว่างหน้า-หลังให้
level คือรหัสระดับตำแหน่ง (Level.Id ในผลลัพธ์) — ตำแหน่งที่ลงหลายช่องทางจะตรงเมื่อมีช่องทางใดใช้ระดับนี้
recruitmentStatus ใช้สถานะรวมของตำแหน่ง (ดูหัวข้อสถานะด้านล่าง)
ส่งหลายตัวกรองพร้อมกันได้ ผลลัพธ์ต้องตรงทุกเงื่อนไข
page เริ่มที่ 1 (ไม่ส่ง = 1), limit ไม่ส่ง = 20 สูงสุด 100
ผลลัพธ์เรียงจากตำแหน่งที่สร้างล่าสุดก่อน (PositionId มากไปน้อย) เสมอ
Totals คือจำนวนตำแหน่ง ทั้งหมด ที่ตรงเงื่อนไข ไม่ใช่จำนวนในหน้านี้
📘 สถานะการรับสมัคร
ตำแหน่งเดียวลงได้หลายช่องทาง (เช่น career site ของบริษัท, emjobs) และเปิดปิดแยกกันได้ — ดูสถานะรายช่องทางได้จาก Companies
สถานะของแต่ละช่องทาง: ปิดรับสมัครอยู่ = closed, เปิดและถึงวันประกาศแล้ว (หรือไม่ได้กำหนดวันประกาศ) = open, เปิดแต่ยังไม่ถึงวันประกาศ = scheduled
สถานะรวมของตำแหน่ง: มีช่องทางที่ open อย่างน้อยหนึ่งช่อง = open, ไม่มี open แต่มี scheduled = scheduled, นอกนั้น closed
IsRecruiting เป็น true เฉพาะเมื่อสถานะเป็น open
⚠️ ข้อควรรู้
1 รายการต่อ 1 ตำแหน่ง (PositionId) — ตำแหน่งที่ชื่อซ้ำกันจะแยกเป็นคนละรายการเสมอ
ข้อมูลทั่วไป (ระดับ ประเภทงาน เงินเดือน รายละเอียดงาน ฯลฯ) มาจากช่องทางหลักของตำแหน่ง ใช้ลำดับเดียวกับหน้ารายการตำแหน่งในระบบ empeo
MinimumSalary / MaximumSalary เป็นตัวเลขจริงเสมอ แม้ตำแหน่งตั้งซ่อนเงินเดือนไว้ — ดู IsShowSalary ก่อนนำไปแสดงต่อ
ถ้าปิดการตั้งค่าหมวดใดไว้ ฟิลด์ย่อยของหมวดนั้นจะเป็น null หรือรายการว่าง แม้ระบบจะยังเก็บค่าเดิมไว้
ผู้พิจารณาและผู้ดูแลตำแหน่งแสดงเฉพาะพนักงานที่ยังทำงานอยู่และมีบัญชีผู้ใช้ที่เปิดใช้งาน
ส่งตัวอักษรใน page / limit / level จะได้ 400 แบบ ProblemDetails ของ ASP.NET (errors แยกตาม parameter) ไม่ใช่ ApiResultBff
🔐 ต้องมีสิทธิ์ Open API โมดูล Recruitment ระดับ Read

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.gofive.co.thempeo/api/v1/positions?name=Programmer&level=3001&recruitmentStatus=open&page=1&limit=20' \
--header 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
สำเร็จ — Data คือตำแหน่งในหน้านี้ และ Totals คือจำนวนทั้งหมดที่ตรงเงื่อนไข
Bodyapplication/json

Examples
{
    "StatusCode": 200,
    "Message": "OK",
    "Totals": 1,
    "Data": [
        {
            "PositionId": 101,
            "PositionName": "โปรแกรมเมอร์",
            "PositionName_EN": "Programmer",
            "Level": {
                "Id": 3001,
                "Name": "ระดับต้น",
                "Name_EN": "Junior"
            },
            "JobCategory": {
                "Id": 9001,
                "Name": "ไอที",
                "Name_EN": "Information Technology"
            },
            "EmploymentType": {
                "Id": 2001,
                "Name": "พนักงานประจำ",
                "Name_EN": "Full-time"
            },
            "Companies": [
                {
                    "CompanyId": 5567,
                    "Name": "Acme",
                    "RecruitmentStatus": "open",
                    "IsRecruiting": true
                },
                {
                    "CompanyId": 5568,
                    "Name": "Acme on emjobs",
                    "RecruitmentStatus": "closed",
                    "IsRecruiting": false
                }
            ],
            "WorkLocation": {
                "Id": 15,
                "Name": "สำนักงานใหญ่",
                "Name_EN": "Head office"
            },
            "Province": {
                "Id": 10,
                "Name": "กรุงเทพมหานคร",
                "Name_EN": "Bangkok"
            },
            "DateAnnounced": "2026-10-01T00:00:00",
            "MinimumSalary": 30000,
            "MaximumSalary": 45000,
            "IsShowSalary": true,
            "Overview": "<p>ร่วมพัฒนาระบบของบริษัทตัวอย่าง</p>",
            "Responsibility": "<ul><li>พัฒนาและดูแลระบบ</li></ul>",
            "Qualifications": "<ul><li>ปริญญาตรีสาขาที่เกี่ยวข้อง</li></ul>",
            "YoutubeURL": "https://cdn.example.com/videos/programmer",
            "RecruitmentStatus": "open",
            "IsRecruiting": true,
            "Benefits": [
                {
                    "BenefitId": 4,
                    "Name": "สวัสดิการพนักงาน",
                    "Name_EN": "Employee benefits",
                    "Description": "**สวัสดิการ**\n• ประกันสุขภาพ\n• โบนัสประจำปี",
                    "Description_EN": "**Benefits**\n• Health insurance\n• Annual bonus"
                }
            ],
            "Assessment": {
                "IsEnabled": true,
                "SendCondition": "aiScore",
                "MinimumAiScore": 70,
                "AssessmentSets": [
                    {
                        "SetId": 12,
                        "Name": "แบบทดสอบโปรแกรมเมอร์",
                        "Name_EN": "Programmer test"
                    }
                ]
            },
            "Interview": {
                "IsAutoBooking": true,
                "BookingPlatform": "calendio",
                "EventTypeId": 5,
                "InterviewDuration": 30,
                "IsAiInterview": true
            },
            "PreOnboarding": {
                "IsEnabled": true,
                "Courses": [
                    {
                        "CourseId": 7,
                        "Name": "ปฐมนิเทศพนักงานใหม่"
                    }
                ]
            },
            "DataProcessing": {
                "IsCustomAiScoreCriteria": true,
                "IsCriteriaChecklist": true,
                "CriteriaChecklist": "ปริญญาตรีวิศวกรรมคอมพิวเตอร์ ประสบการณ์ 2 ปีขึ้นไป"
            },
            "Stakeholders": {
                "Considers": [
                    {
                        "EmployeeNo": "EMP001"
                    }
                ],
                "Coordinators": [
                    {
                        "EmployeeNo": "EMP002"
                    }
                ]
            },
            "DateCreated": "2026-09-15T10:30:00",
            "DateModified": "2026-10-01T09:00:00"
        }
    ]
}
🟠400
🟠401Unauthorized
🟠403Forbidden
🟠429TooManyRequests
🔴500InternalServerErrorNoBody
Modified at 2026-10-15 07:45:25
Previous
Get Candidate
Next
Get Time Attendance
Built with