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

# Headcount Trends API Quickstart

> Make your first Headcount Trends call and read total employees and growth rates.

## Authentication

All requests must include an **API key** in the `x-api-key` HTTP header.

```text theme={null}
x-api-key: <YOUR_API_KEY>
```

<Warning>
  Never expose your API key in client-side code, browser requests, or public repositories. A missing or invalid key returns `401 Unauthorized`.
</Warning>

## Execute your first request

<CodeGroup>
  ```bash cURL theme={null}
  curl -G "https://api.akta.pro/api/v1/company/headcount-trends/" \
    --data-urlencode "company=00000l1" \
    -H "x-api-key: <YOUR_API_KEY>"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.akta.pro/api/v1/company/headcount-trends",
      headers={"x-api-key": "<YOUR_API_KEY>"},
      params={"company": "00000l1"}
  )
  data = response.json()
  hc = data["data"]

  total = hc["total_employees"]
  growth_12mo = next(
      (g["change_percentage"] for g in hc["growth_periods"] if g["month_difference"] == 12),
      None
  )
  print(f"Total employees: {total:,}  |  12-month growth: {growth_12mo}%")
  ```
</CodeGroup>

**Sample Response**

```python expandable theme={null}
{
  "data": {
    "uuid": "00000l1",
    "linkedin_username": "canva",
    "linkedin_official_name": "Canva",
    "linkedin_id": "2850862",
    "total_employees": 18966,
    "growth_periods": [
      {
        "month_difference": 6,
        "change_percentage": 29
      },
      {
        "month_difference": 12,
        "change_percentage": 75
      },
      {
        "month_difference": 24,
        "change_percentage": 117
      }
    ],
    "headcount_monthly": [
      {
        "employee_count": 8746,
        "date": "2024-08-01"
      },
      {
        "employee_count": 8853,
        "date": "2024-09-01"
      },
      {
        "employee_count": 8933,
        "date": "2024-10-01"
      },
      {
        "employee_count": 8983,
        "date": "2024-11-01"
      },
      {
        "employee_count": 9040,
        "date": "2024-12-01"
      },
      {
        "employee_count": 9334,
        "date": "2025-01-01"
      },
      {
        "employee_count": 9463,
        "date": "2025-02-01"
      },
      {
        "employee_count": 9619,
        "date": "2025-03-01"
      },
      {
        "employee_count": 9788,
        "date": "2025-04-01"
      },
      {
        "employee_count": 10010,
        "date": "2025-05-01"
      },
      {
        "employee_count": 10245,
        "date": "2025-06-01"
      },
      {
        "employee_count": 10474,
        "date": "2025-07-01"
      },
      {
        "employee_count": 10837,
        "date": "2025-08-01"
      },
      {
        "employee_count": 11116,
        "date": "2025-09-01"
      },
      {
        "employee_count": 11708,
        "date": "2025-10-01"
      },
      {
        "employee_count": 12447,
        "date": "2025-11-01"
      },
      {
        "employee_count": 13066,
        "date": "2025-12-01"
      },
      {
        "employee_count": 13968,
        "date": "2026-01-01"
      },
      {
        "employee_count": 14653,
        "date": "2026-02-01"
      },
      {
        "employee_count": 15337,
        "date": "2026-03-01"
      },
      {
        "employee_count": 16032,
        "date": "2026-04-01"
      },
      {
        "employee_count": 16847,
        "date": "2026-05-01"
      },
      {
        "employee_count": 17798,
        "date": "2026-06-01"
      },
      {
        "employee_count": 18495,
        "date": "2026-07-01"
      },
      {
        "employee_count": 18966,
        "date": "2026-08-01"
      }
    ],
    "date": "2026-08-01",
    "headcount_by_function": [
      {
        "name": "Arts and Design",
        "employee_count": 5656,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 38
          },
          {
            "month_difference": 12,
            "change_percentage": 80
          }
        ]
      },
      {
        "name": "Engineering",
        "employee_count": 2541,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 13
          },
          {
            "month_difference": 12,
            "change_percentage": 34
          }
        ]
      },
      {
        "name": "Media and Communication",
        "employee_count": 1414,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 33
          },
          {
            "month_difference": 12,
            "change_percentage": 81
          }
        ]
      },
      {
        "name": "Marketing",
        "employee_count": 1107,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 34
          },
          {
            "month_difference": 12,
            "change_percentage": 66
          }
        ]
      },
      {
        "name": "Education",
        "employee_count": 1022,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 47
          },
          {
            "month_difference": 12,
            "change_percentage": 173
          }
        ]
      },
      {
        "name": "Sales",
        "employee_count": 821,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 41
          },
          {
            "month_difference": 12,
            "change_percentage": 115
          }
        ]
      },
      {
        "name": "Administrative",
        "employee_count": 644,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 42
          },
          {
            "month_difference": 12,
            "change_percentage": 132
          }
        ]
      },
      {
        "name": "Operations",
        "employee_count": 594,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 31
          },
          {
            "month_difference": 12,
            "change_percentage": 105
          }
        ]
      },
      {
        "name": "Information Technology",
        "employee_count": 588,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 7
          },
          {
            "month_difference": 12,
            "change_percentage": 27
          }
        ]
      },
      {
        "name": "Support",
        "employee_count": 403,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 21
          },
          {
            "month_difference": 12,
            "change_percentage": 54
          }
        ]
      },
      {
        "name": "Business Development",
        "employee_count": 416,
        "growth_periods": [
          {
            "month_difference": 6,
            "change_percentage": 25
          },
          {
            "month_difference": 12,
            "change_percentage": 108
          }
        ]
      }
    ]
  },
  "credits_consumed": 2.5
}
```