openapi: 3.2.0
info:
  description: Rollee Company API allows to use our services with a REST API
  title: Company Employer endpoints API
  contact: {}
  version: '0.5'
servers:
- url: https://api.getrollee.com/api/company/v0.5
tags:
- name: Employer endpoints
paths:
  /company_accounts/{id}/absences:
    get:
      description: Get Absences informations of a company account
      tags:
      - Employer endpoints
      summary: Get company absences
      parameters:
      - description: company id
        name: id
        in: path
        required: true
        schema:
          type: string
      - description: user account id, if we are interested on a specific user
        name: user_account
        in: query
        schema:
          type: string
      - description: query data filtering by a date range that starts at this time (unix timestamp). The default value is 30 days ago.
        name: start_date
        in: query
        schema:
          type: number
      - description: query data filtering by a date range that ends at this time (unix timestamp). The default value is the current day.
        name: end_date
        in: query
        schema:
          type: number
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.CompanyAccountsAbsences'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: getCompanyAccountsByIdAbsences
      x-operation-id-source: derived
  /company_accounts/{id}/employees:
    get:
      description: Get employees of a company account
      tags:
      - Employer endpoints
      summary: Get company employees
      parameters:
      - description: company id
        name: id
        in: path
        required: true
        schema:
          type: string
      - description: user account id, if we are interested on a specific user
        name: user_account
        in: query
        schema:
          type: string
      - description: query data filtering by a date range that starts at this time (unix timestamp). The default value is 30 days ago.
        name: start_date
        in: query
        schema:
          type: number
      - description: query data filtering by a date range that ends at this time (unix timestamp). The default value is the current day.
        name: end_date
        in: query
        schema:
          type: number
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.CompanyAccountsEmployees'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: getCompanyAccountsByIdEmployees
      x-operation-id-source: derived
components:
  schemas:
    std_models.Absence:
      type: object
      properties:
        absence_end:
          type: string
        absence_reason:
          type: string
        absence_request_status:
          type: string
        absence_start:
          type: string
        days_taken:
          type: number
        employee:
          type: string
    handlers.AccountSingleDataResponse-std_models_Employee:
      type: object
      properties:
        endpoint_data:
          $ref: '#/components/schemas/std_models.Employee'
        user_account_id:
          type: string
        user_id:
          type: string
    models.ServerError:
      type: object
      properties:
        error:
          type: string
    models.CompanyAccountsEmployees:
      type: object
      properties:
        size:
          type: integer
        users_data:
          type: array
          items:
            $ref: '#/components/schemas/handlers.AccountSingleDataResponse-std_models_Employee'
    models.CompanyAccountsAbsences:
      type: object
      properties:
        size:
          type: integer
        users_data:
          type: array
          items:
            $ref: '#/components/schemas/handlers.AccountSingleDataResponse-std_models_Absence'
    std_models.Employee:
      type: object
      properties:
        acquired_night_hours:
          type: number
        acquired_other:
          type: number
        acquired_overtime:
          type: number
        acquired_total:
          type: number
        additional_address:
          type: string
        annual_salary:
          type: number
        annual_salary_note:
          type: string
        balance_night_hour:
          type: number
        balance_other:
          type: number
        balance_overtime:
          type: number
        balance_total:
          type: number
        bank_account_number:
          type: string
        benefits_in_kind:
          type: number
        bic:
          type: string
        bonuses_of_the_month:
          type: number
        city:
          type: string
        company_id:
          type: string
        company_name:
          type: string
        contract_end_date:
          type: string
        contract_salary:
          type: number
        contract_type:
          type: string
        contractual_time:
          type: string
        country:
          type: string
        country_of_birth:
          type: string
        country_phone_code:
          type: string
        currency:
          type: string
        date_of_birth:
          type: string
        dependent_children:
          type: string
        email:
          type: string
        emergency_contact_name:
          type: string
        emergency_contact_phone:
          type: string
        employee:
          type: string
        employee_number:
          type: string
        extra_time_amount:
          type: number
        first_name:
          type: string
        full_name:
          type: string
        gender:
          type: string
        gross_salary:
          type: number
        iban:
          type: string
        is_employed:
          type: boolean
        is_in_probation_period:
          type: boolean
        job:
          type: string
        job_birthday:
          type: string
        job_category:
          type: string
        job_classification:
          type: string
        last_name:
          type: string
        management_level:
          type: string
        manager:
          type: string
        meal_voucher:
          type: number
        monthly_salary:
          type: number
        nationality:
          type: string
        net_salary:
          type: number
        payment_method:
          type: string
        period:
          type: string
        phone:
          type: string
        place_of_birth:
          type: string
        probation_end_date:
          type: string
        probation_start_date:
          type: string
        professional_fees:
          type: number
        social_security_number:
          type: string
        start_of_contract:
          type: string
        street:
          type: string
        student:
          type: string
        taken_night_hours:
          type: number
        taken_other:
          type: number
        taken_overtime:
          type: number
        taken_total:
          type: number
        taxes:
          type: number
        title:
          type: string
        total_cost:
          type: number
        travel_fee:
          type: number
        use_name:
          type: string
        value_share_amount_paid:
          type: number
        value_share_exempt_amount:
          type: number
        value_share_last_month_of_payment:
          type: string
        value_share_remaining_exemption:
          type: number
        work_permit_end_date:
          type: string
        zip:
          type: string
    handlers.AccountSingleDataResponse-std_models_Absence:
      type: object
      properties:
        endpoint_data:
          $ref: '#/components/schemas/std_models.Absence'
        user_account_id:
          type: string
        user_id:
          type: string
x-provenance:
  method: searched
  source: https://developers.getrollee.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developers.getrollee.com/reference/delete_companies-id.md
  - https://developers.getrollee.com/reference/get_companies-id-company-accounts.md
  - https://developers.getrollee.com/reference/get_companies-id.md
  - https://developers.getrollee.com/reference/get_companies.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-absences.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-activity.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-banking-info.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-documents.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-employees.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-employment.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-income.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-performance.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-profiles.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-trips.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-vehicles.md
  - https://developers.getrollee.com/reference/get_company-accounts-id-wallet.md
  - https://developers.getrollee.com/reference/get_company-accounts-id.md
  - https://developers.getrollee.com/reference/get_token-refresh.md
  - https://developers.getrollee.com/reference/get_users-id.md
  - https://developers.getrollee.com/reference/get_webhooks-1.md
  - https://developers.getrollee.com/reference/post_companies.md
  - https://developers.getrollee.com/reference/post_company-accounts-id-reconnect.md
  - https://developers.getrollee.com/reference/post_sessions-session-refresh.md
  - https://developers.getrollee.com/reference/put_company-v0-5-webhooks-accounts.md
  - https://developers.getrollee.com/reference/put_company-v0-5-webhooks-endpoints.md
  - https://developers.getrollee.com/reference/put_company-v0-5-webhooks-multi-endpoints.md
  - https://developers.getrollee.com/reference/put_users-id.md
  merge:
    pages: 27
    deduped: 49
    conflicts_kept_first: 0