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

# Population API

> Access Dzaleka Refugee Camp population statistics and demographics

## GET /api/population

Retrieve current population statistics and demographic data for Dzaleka Refugee Camp.

### Query Parameters

No query parameters required.

### Response Format

<ResponseField name="total" type="number" required>
  Total camp population
</ResponseField>

<ResponseField name="newArrivals" type="number" required>
  Number of new arrivals (recent period)
</ResponseField>

<ResponseField name="demographics" type="object" required>
  Demographic breakdown by gender and age

  <ResponseField name="women" type="number">
    Percentage of women
  </ResponseField>

  <ResponseField name="children" type="number">
    Percentage of children
  </ResponseField>

  <ResponseField name="men" type="number">
    Percentage of men
  </ResponseField>
</ResponseField>

<ResponseField name="nationalities" type="object" required>
  Breakdown by country of origin (percentages)

  <ResponseField name="DRC" type="number">
    Democratic Republic of Congo
  </ResponseField>

  <ResponseField name="Burundi" type="number">
    Burundi
  </ResponseField>

  <ResponseField name="Rwanda" type="number">
    Rwanda
  </ResponseField>

  <ResponseField name="Somalia" type="number">
    Somalia
  </ResponseField>

  <ResponseField name="Ethiopia" type="number">
    Ethiopia
  </ResponseField>

  <ResponseField name="Other" type="number">
    Other countries
  </ResponseField>
</ResponseField>

<ResponseField name="trends" type="object" required>
  Historical population trends

  <ResponseField name="labels" type="array">
    Array of year labels
  </ResponseField>

  <ResponseField name="values" type="array">
    Array of population values corresponding to labels
  </ResponseField>
</ResponseField>

### Example Request

```bash theme={null}
curl https://services.dzaleka.com/api/population
```

### Example Response

```json theme={null}
{
  "total": 55425,
  "newArrivals": 304,
  "demographics": {
    "women": 45,
    "children": 48,
    "men": 7
  },
  "nationalities": {
    "DRC": 64.9,
    "Burundi": 21.9,
    "Rwanda": 12.6,
    "Somalia": 0.3,
    "Ethiopia": 0.3,
    "Other": 0.1
  },
  "trends": {
    "labels": ["2019", "2020", "2021", "2022", "2023", "2024"],
    "values": [40000, 45000, 48000, 50000, 52258, 55425]
  }
}
```

## Understanding the Data

### Demographics

The demographics percentages show:

* **45% women** - Adult female population
* **48% children** - Under 18 years old
* **7% men** - Adult male population

<Note>
  The demographics percentages relate to new arrivals composition, not the total population breakdown.
</Note>

### Nationalities

Dzaleka is home to refugees primarily from:

1. **Democratic Republic of Congo (64.9%)** - Largest group
2. **Burundi (21.9%)** - Second largest
3. **Rwanda (12.6%)** - Third largest
4. **Other countries (0.7%)** - Somalia, Ethiopia, and others

### Population Growth

The trends data shows steady growth from 40,000 in 2019 to over 55,000 in 2024, reflecting:

* New refugee arrivals
* Natural population growth
* Family reunifications

## Use Cases

* Visualize population trends on dashboards
* Plan service capacity and resource allocation
* Report generation for stakeholders
* Research and analysis

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Weather API" icon="cloud" href="/api/weather">
    Local weather forecast
  </Card>

  <Card title="Services API" icon="building" href="/api/services">
    Community services directory
  </Card>
</CardGroup>