EmployeeReview

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/akta-pro/main/json-schema/akta-pro-employee-review-schema.json",
  "title": "EmployeeReview",
  "x-generated": "2026-10-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/akta-pro-openapi.yml#/components/schemas/EmployeeReview",
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Company UUID."
    },
    "employee_reviews": {
      "type": "object",
      "properties": {
        "overall_rating": {
          "type": "object",
          "description": "Overall company rating per review provider. Keys are provider identifiers (e.g. glassdoor), values are floats."
        },
        "other_ratings": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Rating dimension. Example: business_outlook, ceo, recommend_to_friend, compensation_and_benefits, culture_and_values, diversity_and_inclusion, senior_management, work_life_balance."
              },
              "provider": {
                "type": "string",
                "description": "Review provider identifier."
              },
              "value": {
                "type": "number",
                "description": "Rating value. Sentiment-style dimensions (business_outlook, ceo, recommend_to_friend) are 0 to 1 percentage; other dimensions are 0 to 5 scale."
              }
            }
          },
          "description": "Dimension-level ratings broken out per provider."
        },
        "reviews": {
          "type": "object",
          "properties": {
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/EmployeeReviewItem"
              }
            },
            "total": {
              "type": "integer",
              "description": "Total number of reviews available for the company across all providers."
            },
            "total_by_provider": {
              "type": "object",
              "description": "Total review count broken down by provider."
            }
          }
        }
      }
    }
  },
  "$defs": {
    "EmployeeReviewItem": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "Unique identifier for the review."
        },
        "summary": {
          "type": "string",
          "description": "Review headline or summary."
        },
        "pros": {
          "type": "string",
          "description": "Pros described by the reviewer."
        },
        "cons": {
          "type": "string",
          "description": "Cons described by the reviewer."
        },
        "rating": {
          "type": "integer",
          "description": "Overall star rating given by the reviewer."
        },
        "review_link": {
          "type": "string",
          "description": "Link to the original review on the provider's site."
        },
        "job_title": {
          "type": "string",
          "description": "Job title of the reviewer."
        },
        "review_date": {
          "type": "string",
          "description": "Publication date of the review."
        },
        "employment_status": {
          "type": "string",
          "description": "Employment type of the reviewer. Example: REGULAR, CONTRACT."
        },
        "is_current_employee": {
          "type": "boolean",
          "description": "True if the reviewer was a current employee at the time of writing."
        },
        "years_of_employment": {
          "type": "integer",
          "description": "Reviewer's tenure at the company in years."
        },
        "location": {
          "type": "string",
          "description": "Location of the reviewer."
        },
        "country_code": {
          "type": "string",
          "description": "Country code of the reviewer's location."
        },
        "helpful_count": {
          "type": "integer",
          "description": "Number of users who marked the review as helpful."
        },
        "not_helpful_count": {
          "type": "integer",
          "description": "Number of users who marked the review as not helpful."
        },
        "career_opportunities_rating": {
          "type": "integer",
          "description": "Reviewer's rating for career opportunities."
        },
        "ceo_rating": {
          "type": "string",
          "description": "Reviewer's CEO sentiment. Example: APPROVE, DISAPPROVE."
        },
        "compensation_and_benefits_rating": {
          "type": "integer",
          "description": "Reviewer's rating for compensation and benefits."
        },
        "culture_and_values_rating": {
          "type": "integer",
          "description": "Reviewer's rating for culture and values."
        },
        "diversity_and_inclusion_rating": {
          "type": "integer",
          "description": "Reviewer's rating for diversity and inclusion."
        },
        "senior_management_rating": {
          "type": "integer",
          "description": "Reviewer's rating for senior management."
        },
        "work_life_balance_rating": {
          "type": "integer",
          "description": "Reviewer's rating for work-life balance."
        },
        "language": {
          "type": "string",
          "description": "Language code of the review."
        },
        "provider": {
          "type": "string",
          "description": "Review provider identifier."
        }
      }
    }
  }
}