Skip to main content
GET
/
api
/
dashboard-admin
/
distribucion
Request Distribution
curl --request GET \
  --url https://api.example.com/api/dashboard-admin/distribucion
{
  "500": {},
  "status": "<string>",
  "data": {
    "por_tipo": [
      {
        "id_tipo": 123,
        "nombre": "<string>",
        "total": 123
      }
    ],
    "por_estado": [
      {
        "id_estado": 123,
        "nombre": "<string>",
        "total": 123
      }
    ]
  }
}

​
Overview

This endpoint returns request distribution analytics, showing breakdowns by request type and by status. It can be filtered by time range and scoped to a specific employee or organization-wide.

​
Authentication

Requires JWT authentication token. Typically used by admins for analytics dashboards.

​
Query Parameters

​
rango
string
Time range filter. Supported values:
  • mes_actual - Current month only
  • Omit parameter for all-time data
​
empleado_id
integer
Optional employee ID. If provided, returns distribution for that employee only. If omitted, returns organization-wide distribution.

​
Response

​
status
string
Response status (“success”)
​
data
object
Distribution data object
​
por_tipo
array
Array of request counts grouped by type
​
id_tipo
integer
Request type ID
​
nombre
string
Request type name (e.g., “Vacaciones”, “Permiso”, “Ausencia”, “Trabajo Exterior”)
​
total
integer
Count of requests for this type
​
por_estado
array
Array of request counts grouped by status
​
id_estado
integer
Request status ID
​
nombre
string
Request status name (e.g., “Pendiente”, “Aprobada”, “Rechazada”, “Cancelada”)
​
total
integer
Count of requests with this status

​
Error Responses

​
500
object
Internal server error
{
  "status": "error",
  "message": "Error al obtener distribución."
}

​
Code Examples

​
All-time Organization Distribution

cURL
curl -X GET 'https://api.example.com/api/dashboard-admin/distribucion' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
JavaScript
// Get all-time organization-wide distribution
const response = await fetch('https://api.example.com/api/dashboard-admin/distribucion', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  }
});

const distribution = await response.json();

// Display distribution by type
console.log('By Type:');
distribution.data.por_tipo.forEach(item => {
  console.log(`  ${item.nombre}: ${item.total}`);
});

// Display distribution by status
console.log('\nBy Status:');
distribution.data.por_estado.forEach(item => {
  console.log(`  ${item.nombre}: ${item.total}`);
});
Python
import requests

# All-time organization distribution
url = 'https://api.example.com/api/dashboard-admin/distribucion'
headers = {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
data = response.json()['data']

print('Distribution by Type:')
for item in data['por_tipo']:
    print(f"  {item['nombre']}: {item['total']}")

print('\nDistribution by Status:')
for item in data['por_estado']:
    print(f"  {item['nombre']}: {item['total']}")

​
Current Month Employee Distribution

cURL
curl -X GET 'https://api.example.com/api/dashboard-admin/distribucion?rango=mes_actual&empleado_id=42' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
JavaScript
// Get current month distribution for specific employee
const employeeId = 42;
const response = await fetch(
  `https://api.example.com/api/dashboard-admin/distribucion?rango=mes_actual&empleado_id=${employeeId}`,
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_JWT_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);

const distribution = await response.json();
console.log('Current month distribution:', distribution.data);
Python
import requests

# Current month employee distribution
employee_id = 42
url = 'https://api.example.com/api/dashboard-admin/distribucion'
params = {
    'rango': 'mes_actual',
    'empleado_id': employee_id
}
headers = {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
}

response = requests.get(url, params=params, headers=headers)
data = response.json()['data']

print(f"Distribution for employee {employee_id} (current month):")
print(f"By type: {data['por_tipo']}")
print(f"By status: {data['por_estado']}")

​
Example Responses

​
Organization-wide All-time Distribution

{
  "status": "success",
  "data": {
    "por_tipo": [
      {
        "id_tipo": 1,
        "nombre": "Vacaciones",
        "total": 245
      },
      {
        "id_tipo": 2,
        "nombre": "Permiso",
        "total": 132
      },
      {
        "id_tipo": 3,
        "nombre": "Ausencia",
        "total": 78
      },
      {
        "id_tipo": 4,
        "nombre": "Trabajo Exterior",
        "total": 56
      }
    ],
    "por_estado": [
      {
        "id_estado": 1,
        "nombre": "Pendiente",
        "total": 23
      },
      {
        "id_estado": 2,
        "nombre": "Aprobada",
        "total": 412
      },
      {
        "id_estado": 3,
        "nombre": "Rechazada",
        "total": 45
      },
      {
        "id_estado": 4,
        "nombre": "Cancelada",
        "total": 31
      }
    ]
  }
}

​
Employee Current Month Distribution

{
  "status": "success",
  "data": {
    "por_tipo": [
      {
        "id_tipo": 1,
        "nombre": "Vacaciones",
        "total": 1
      },
      {
        "id_tipo": 2,
        "nombre": "Permiso",
        "total": 2
      }
    ],
    "por_estado": [
      {
        "id_estado": 1,
        "nombre": "Pendiente",
        "total": 1
      },
      {
        "id_estado": 2,
        "nombre": "Aprobada",
        "total": 2
      }
    ]
  }
}

​
Visualization Examples

Pie Chart by Type

Use por_tipo data to create a pie chart showing the composition of request types

Bar Chart by Status

Use por_estado data to create a bar chart showing approval rates and pending volumes

Stacked Chart

Combine both datasets to show request types broken down by status

Comparison View

Compare current month vs all-time distributions to identify trends

​
Use Cases

Analytics Dashboard

Display distribution charts on admin dashboard for insights into request patterns

Resource Planning

Understand which request types are most common to plan resources accordingly

Approval Metrics

Calculate approval rates by comparing approved vs rejected/cancelled counts

Employee Reports

Generate employee-specific reports showing their request history breakdown

Build docs developers (and LLMs) love

Get started for freeTalk to us