Ir al contenido

Listar proyectos

GET/api/project

Devuelve la lista paginada de proyectos. Usa BaseControllerHelper::index. Los parámetros comunes (per_page, status, trashed, ids, fechas…) se describen en Paginación y filtros. Aquí solo se listan los propios del proyecto.

searchstring

Texto a buscar en name y code.

filtersstring

Filtros por campo con el formato campo:valor, separados por coma. Campos admitidos: customer_id, opportunity_id, project_manager_id, seller_id, cost_center_type_id, warehouse_id y los *_user_id de auditoría.

relationsstring

Relaciones a cargar. Ver Resumen.

count_relationsstring

Sin efecto: el modelo no define conteos permitidos.

orderstring

Orden de los resultados. Campos permitidos: id, name, created_at, updated_at, status. Por defecto id|DESC.

No exige un permiso del módulo: ProjectPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/project" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "search=planta" \
--data-urlencode "filters=customer_id:5" \
--data-urlencode "relations=customer[id-name]" \
--data-urlencode "order=created_at|DESC"
Lista de proyectos200
{
"current_page": 1,
"data": [
{
"id": 1,
"customer_id": 5,
"opportunity_id": 12,
"name": "Instalación eléctrica Planta Norte",
"description": "Instalación de tableros y cableado",
"start_date": "2026-11-02T00:00:00.000000Z",
"end_date": "2027-11-02T00:00:00.000000Z",
"investment": 300000,
"code": "110001",
"duration_type": null,
"project_manager_id": 3,
"seller_id": 4,
"comercial_conditions": null,
"cost_center_type_id": 2,
"warehouse_id": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null,
"customer": {
"id": 5,
"name": "CONSTRUCTORA NORTE S.A.C."
}
}
],
"first_page_url": "https://servererp.allendostmen.app/api/project?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/project?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/project",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}