Ir al contenido

Listar cuentas de cliente

GET/api/customer-account

Devuelve la lista paginada de cuentas de cliente. Usa BaseControllerHelper::index. Los parámetros comunes (search, status, trashed, ids, fechas, per_page…) se describen en Paginación y filtros; aquí se documentan solo los propios de este endpoint.

per_pageinteger

Registros por página. Por defecto 20.

searchstring

Texto a buscar en responsible y account_number.

customer_idinteger

Filtra por cliente.

account_typestring

Filtra por tipo de cuenta: detracción o recaudación.

bank_idinteger

Filtra por banco.

orderstring

Orden de los resultados, con la forma campo|ASC o campo|DESC. Campos permitidos: id, name, responsible, account_number, status, created_at, updated_at.

relationsstring

Relaciones a cargar: bank, customer y coin. Ver Resumen.

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

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/customer-account" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "customer_id=12" \
--data-urlencode "account_type=recaudación"
Lista de cuentas de cliente200
{
"current_page": 1,
"data": [
{
"id": 1,
"customer_id": 12,
"bank_id": 3,
"coin_id": 1,
"responsible": "Juan Pérez",
"name": "Cuenta soles",
"account_number": "19412345678",
"account_type": "recaudación",
"email": null,
"description": 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
}
],
"per_page": 20,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}