Listado de Contactos

Este endpoint obtiene el listado de contactos de su empresa en CMMShere

HTTP Request

GET https://admin.cmmshere.com/api/v1/contacts

Parámetros de consulta

Estos parametros son opcionales y utilizados para filtrar e interactuar con la información obtenida. Los parámetros de filtrado (si se utilizan) se usan para buscar resultados que contengan dicho texto.

Parámetro	Tipo	Default	Descripción
nombre	String	No definido	Si se utiliza, el resultado solo incluirá contactos que contengan ese nombre
cargo	String	No definido	Si se utiliza, el resultado solo incluirá contactos que contengan ese cargo
email	String	No definido	Si se utiliza, el resultado solo incluirá contactos que contengan ese email
cliente_id	Int	No definido	Si se utiliza, el resultado solo incluirá contactos de ese cliente especifico (basado en su ID) API relacionada
offset	Int	No definido	Offset para paginación
limit	Int	No definido	Limite para paginación
orderBy	Array	["created_at", "desc"]	Ordenamiento. El primer valor es el campo y el segundo la direccion ASC o DESC

Ejemplo de petición

cURL

curl --location --request GET 'https://admin.cmmshere.com/api/v1/contacts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 804|fCkDcz43egLAubMzPinRCIVUIjPUsGkvbVJ864IP' \
--header 'Cookie: XSRF-TOKEN=eyJpdiI6ImwzTUd1dTJiNlROM1VlL1Y0akYyWVE9PSIsInZhbHVlIjoiNFNUdFBvTWtyNXlDTXZZUmJtM0hBTkplNnlWcmM5MTI5VVA5SnVVQ09kTUJIQkRtMll3eHZ0WXNrUFp6NllsSXdMQjd5Tk8veUI0MlVaa0c3eEFVa0RHMTNkenkxdWhOOTRKRVoraE9oQnZiTVY2VUpkNmd1RzZtTFpWbmM5V28iLCJtYWMiOiJjYjVhOGM4YTg0OWVmOWI2ZmVjNTdkZDE1ZjgyMTc0NTE4ZTM0ZGU5YjhiNGY1ZGRlZTJkYTg1MmRjNGVlZDY2In0%3D; laravel_session=eyJpdiI6IklKRHVhUHo4SXNUV2JlMEN2SzJ0THc9PSIsInZhbHVlIjoiK2M4RWMrMWZwVWxuWXBBay9tWkhlS2pLUTRrWXFKUS80eXYwWlBpUWlVVUdZenloQnF1b210dk1xd3lwcjNLbDNWc0xJdkNHVGRKbmtLdmFLbGN6Snh6UkpTRjhjSXN5SEtqOGwwTGlZdXNwWnRZcmVvU1pjTmVMM291RXo1R3IiLCJtYWMiOiIxMTEzZmYxMTQzNjllNDNiMmRjOWRkOWE3ZGFlOWVlMGVmYTE2ODZhY2JiNWMxY2NkYmI2MTUxYmJhNDUxN2ZlIn0%3D' \
--data '{
    "offset" : 0,
    "limit" : 5,
    "orderBy" : ["id", "desc"]
}'

La petición de arriba devuelve un JSON estructurado de la siguiente manera

JSON

{
    "success": true,
    "code": 200,
    "results": [
        {
            "id": 5632,
            "client_id": 80,
            "name": "María López Vargas",
            "position": "Gerente Comercial",
            "division": "Ventas",
            "phone": "71234567",
            "cell_phone": null,
            "email": "[email protected]",
            "city": "Ciudad Central",
            "obs": "Cliente frecuente, contacto principal",
            "creator_id": 21,
            "favorite": "1",
            "created_at": "2026-04-24T19:53:14.000000Z"
        },
        {
            "id": 5631,
            "client_id": 80,
            "name": "Aníbal Rojas",
            "position": "Asistente administrativo",
            "division": "Administración",
            "phone": "70123456",
            "cell_phone": null,
            "email": "[email protected]",
            "city": "Ciudad Ejemplo",
            "obs": null,
            "creator_id": 21,
            "favorite": null,
            "created_at": "2026-04-24T19:52:06.000000Z"
        },
        {
            "id": 5616,
            "client_id": 80,
            "name": "Carlos Méndez",
            "position": "Desarrollador",
            "division": "Sistemas",
            "phone": "74561234",
            "cell_phone": null,
            "email": "[email protected]",
            "city": "La Paz",
            "obs": "Seguimiento técnico",
            "creator_id": 21,
            "favorite": "1",
            "created_at": "2026-04-24T18:56:51.000000Z"
        },
        {
            "id": 5274,
            "client_id": 7893,
            "name": "Jorge Aguilar",
            "position": "Gerente",
            "division": "Gerencia",
            "phone": "69437767",
            "cell_phone": null,
            "email": "[email protected]",
            "city": "Santa Cruz",
            "obs": null,
            "creator_id": 292,
            "favorite": "0",
            "created_at": "2026-03-10T15:21:55.000000Z"
        },
        {
            "id": 5242,
            "client_id": 7748,
            "name": "Pedro Alfaro",
            "position": "Contacto",
            "division": null,
            "phone": "76599016",
            "cell_phone": null,
            "email": "[email protected]",
            "city": null,
            "obs": null,
            "creator_id": 30,
            "favorite": "0",
            "created_at": "2026-03-04T21:40:02.000000Z"
        }
    ]
}