# Get Overtimes Documents

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /empeo/api/v1/overtimes/documents:
    get:
      summary: Get Overtimes Documents
      deprecated: false
      description: >-
        ดึงรายละเอียดเอกสาร OT รายพนักงานตามช่วงวันที่
        พร้อมสรุปจำนวนเอกสารและชั่วโมง OT รวม
      operationId: GetOvertimeDocumentsAsync
      tags:
        - empeo/Overtime
        - Overtime
      parameters:
        - name: companyName
          in: query
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: employeeNo
          in: query
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: fromDate
          in: query
          description: ''
          required: true
          example: ''
          schema:
            type: string
            format: date
        - name: toDate
          in: query
          description: ''
          required: true
          example: ''
          schema:
            type: string
            format: date
        - name: otType
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: status
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResultBffOvertimeDocumentResponse'
          headers: {}
          x-apidog-name: ''
        '204':
          description: No Content
          headers: {}
          x-apidog-name: ''
        '403':
          description: Invalid access rights
          content:
            application/json:
              schema: &ref_0
                $ref: '#/components/schemas/ApiResultBffString'
          headers: {}
          x-apidog-name: ''
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema: *ref_0
          headers: {}
          x-apidog-name: ''
      security:
        - bearerAuth: []
          x-apidog:
            schemeGroups:
              - id: 25hzWCBvDME6Y0s3xw9Ot
                schemeIds:
                  - bearerAuth
            required: true
            use:
              id: 25hzWCBvDME6Y0s3xw9Ot
            scopes:
              25hzWCBvDME6Y0s3xw9Ot:
                bearerAuth: []
      x-codeSamples:
        - lang: cURL
          source: >
            curl -X GET
            "https://api.gofive.co.th/empeo/api/v1/overtimes/documents?companyName=Acme&employeeNo=EMP001&fromDate=2026-06-01&toDate=2026-06-30"
            \
              -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
      x-apidog-folder: empeo/Overtime
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/351895/apis/api-38991692-run
components:
  schemas:
    ApiResultBffOvertimeDocumentResponse:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
        totals:
          type: integer
          nullable: true
        data:
          $ref: '#/components/schemas/OvertimeDocumentResponseBffModel'
      x-apidog-orders:
        - statusCode
        - message
        - error
        - totals
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    OvertimeDocumentResponseBffModel:
      type: object
      properties:
        companyName:
          type: string
        employeeNo:
          type: string
        employeeName:
          type: string
        fromDate:
          type: string
          format: date-time
        toDate:
          type: string
          format: date-time
        data:
          type: array
          items:
            $ref: '#/components/schemas/OvertimeDocumentItemBffModel'
        summary:
          $ref: '#/components/schemas/OvertimeDocumentSummaryBffModel'
      x-apidog-orders:
        - companyName
        - employeeNo
        - employeeName
        - fromDate
        - toDate
        - data
        - summary
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    OvertimeDocumentSummaryBffModel:
      type: object
      properties:
        totalItems:
          type: integer
        totalOtHours:
          type: number
          format: double
      x-apidog-orders:
        - totalItems
        - totalOtHours
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    OvertimeDocumentItemBffModel:
      type: object
      properties:
        documentNo:
          type: string
        date:
          type: string
          format: date-time
          nullable: true
        otType:
          type: string
        name:
          type: string
        defaultRate:
          type: number
          format: double
          nullable: true
        startTime:
          type: string
          description: เวลาเริ่มต้น "HH:mm"
        endTime:
          type: string
          description: เวลาสิ้นสุด "HH:mm"
        hours:
          type: number
          format: double
        approvalStatus:
          type: string
        approvedBy:
          type: string
          description: ชื่อผู้อนุมัติ (null = ยังไม่มีผู้อนุมัติ)
          nullable: true
      x-apidog-orders:
        - documentNo
        - date
        - otType
        - name
        - defaultRate
        - startTime
        - endTime
        - hours
        - approvalStatus
        - approvedBy
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    ApiResultBffString:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
        errorList:
          type: string
        totals:
          type: integer
          nullable: true
        data:
          type: string
      x-apidog-orders:
        - statusCode
        - message
        - error
        - errorList
        - totals
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    bearerAuth:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: ใส่ JWT Token ในรูปแบบ Bearer {token}
    bearer:
      type: bearer
      scheme: bearer
servers:
  - url: https://api.gofive.co.th
    description: Production
security:
  - bearerAuth: []
    x-apidog:
      schemeGroups:
        - id: uyL_cJmK7q60QJZRTi5ot
          schemeIds:
            - bearerAuth
      required: true
      use:
        id: uyL_cJmK7q60QJZRTi5ot
      scopes:
        uyL_cJmK7q60QJZRTi5ot:
          bearerAuth: []

```