> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roostedhr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Company HR Info

> This endpoint serves the purpose of fetching company HR information.

Returns an array of the company's HR contacts. Each contact includes the manager name, email, phone number, and whether they are the default HR contact.


## OpenAPI

````yaml api-reference/v01.12.00/openapi-v01.12.00.json GET /company/info/hr
openapi: 3.0.0
info:
  title: Roosted
  version: 0.1.12
  contact:
    name: Support
    url: https://support.roostedhr.com/support/home
    email: support@roostedhr.com
  description: |-
    Enterprise API

    Sandbox keys and Production keys are requested from support
servers:
  - url: https://api.roostedhr.com/api/1_12
  - url: https://sandbox.roostedhr.com/api/1_12
security:
  - X-API-KEY: []
tags:
  - name: Announcements
  - name: Areas
  - name: Clients
  - name: Company
  - name: Configuration
  - name: Events
  - name: Locations
  - name: Payroll Groups
  - name: Rate Cards
  - name: Shifts
  - name: Skillsets
  - name: Time Tracking
  - name: Wage Rules
  - name: Workers
paths:
  /company/info/hr:
    get:
      tags:
        - Company
      summary: Get Company HR Info
      description: This endpoint serves the purpose of fetching company HR information.
      operationId: get-company-info-hr
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyHRContact'
              examples:
                Fetched HR Contacts:
                  value:
                    - id: 1
                      hr_manager: Jane Smith
                      hr_email: hr@company.com
                      hr_phone: '+1234567890'
                      is_default: 1
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Machine-readable error code.
                  error:
                    type: string
                    description: Human-readable error message.
              examples:
                Company name exceeds maximum length:
                  value:
                    code: CMP-100
                    error: Company name exceeds maximum length
                Invalid email format:
                  value:
                    code: CMP-200
                    error: Invalid email format
                Invalid country or timezone ID:
                  value:
                    code: CMP-300
                    error: Invalid country or timezone ID
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Machine-readable error code.
                  error:
                    type: string
                    description: Human-readable error message.
              examples:
                Invalid API key:
                  value:
                    code: ATH-100
                    error: Invalid or missing API key
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Machine-readable error code.
                  error:
                    type: string
                    description: Human-readable error message.
              examples:
                Insufficient permissions:
                  value:
                    code: CMP-1000
                    error: Insufficient permissions to manage company settings
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Machine-readable error code.
                  error:
                    type: string
                    description: Human-readable error message.
              examples:
                Not found:
                  value:
                    code: CMP-600
                    error: Document not found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Machine-readable error code.
                  error:
                    type: string
                    description: Human-readable error message.
              examples:
                Unexpected error:
                  value:
                    code: CMP-1100
                    error: An unexpected error occurred
components:
  schemas:
    CompanyHRContact:
      title: CompanyHRContact
      type: object
      properties:
        id:
          type: integer
          description: Unique HR contact identifier
        hr_manager:
          type: string
          description: HR manager name
        hr_email:
          type: string
          format: email
          description: HR contact email address
        hr_phone:
          type: string
          description: HR contact phone number
        is_default:
          type: integer
          description: Whether this is the default HR contact (0 or 1)
  securitySchemes:
    X-API-KEY:
      name: X-API-KEY
      type: apiKey
      in: header

````