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

# [DRAFT] Get family member

## Overview

Returns a specific family member associated with an employee.


## OpenAPI

````yaml GET /companies/{companyId}/employees/{employeeId}/family-members/{familyMemberId}
openapi: 3.0.1
info:
  title: Partners API
  description: >-
    Partners API definition where you can check the documentation for the
    different available operations to integrate with the platform.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://pre-partners-api.cobee.io/api/v3
  - url: https://partners-api.cobee.io/api/v3
security:
  - bearerAuth: []
paths:
  /companies/{companyId}/employees/{employeeId}/family-members/{familyMemberId}:
    get:
      summary: Get family member
      parameters:
        - name: companyId
          in: path
          required: true
          description: The unique identifier of the company
          schema:
            type: string
            format: uuid
        - name: employeeId
          in: path
          required: true
          description: The unique identifier of the employee
          schema:
            type: string
            format: uuid
        - name: familyMemberId
          in: path
          required: true
          description: The unique identifier of the family member
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Family member successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FamilyMember'
              example:
                id: 7f4c9ba8-9c2d-4b82-8b8c-e5f8f8f8f8f8
                name: Emma
                surname: Smith
                type: child
                gender: female
                birthDate: '2018-04-12'
                nationality: ES
                legalId: 12345678Z
                incapacityLevel: 33%
        '401':
          description: Unauthorised - Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: invalid_token
        '403':
          description: Forbidden - You don't have permission to manage family members
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Company does not belong to the specified partner
        '404':
          description: Not Found - The company, employee, or family member was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Family member not found
        '500':
          description: Internal Server Error - Something went wrong on our end
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Internal server error
components:
  schemas:
    FamilyMember:
      type: object
      required:
        - id
        - name
        - surname
        - type
        - gender
        - birthDate
        - incapacityLevel
        - nationality
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier of the family member
        name:
          type: string
          description: The family member's first name
        surname:
          type: string
          description: The family member's surname
        type:
          type: string
          enum:
            - child
          description: The type of family member
        gender:
          type: string
          enum:
            - male
            - female
          description: The family member's gender
        birthDate:
          type: string
          format: date
          description: The family member's date of birth in ISO 8601 format (YYYY-MM-DD)
        nationality:
          type: string
          pattern: ^[A-Z]{2}$
          description: >-
            The family member's nationality as an ISO 3166-1 alpha-2 country
            code in uppercase
          example: ES
        legalId:
          type: string
          description: The family member's legal identifier
        incapacityLevel:
          type: string
          enum:
            - 0%
            - 33%
            - 66%
          description: The family member's incapacity level
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
      example:
        message: 'Bad request: Invalid field value'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````