v1

latestOpenAPI 3.0.22026-07-26480119.6 KB

Analytics

Retrieves a list of beneficiaries

This endpoint retrieves a comprehensive list of beneficiaries associated with the company group, supporting pagination for efficient data retrieval. It provides detailed information including name, user type (holder or dependent), associated plan, age group, and frequency of usage within the platform.

get/api/company_analytic/v1/beneficiaries

Query parameters

pageinteger

Page number for pagination

Response

returns the beneficiaries list with pagination

Example response

{
  "data": [
    {
      "name": "John Doe",
      "type": "Holder",
      "company_name": "Acme Corp",
      "document_number": "123456789",
      "document_type": "ID",
      "plan": "TP1",
      "age_group": "25-34",
      "frequency": 5
    }
  ],
  "meta": {
    "count": 2,
    "last": 1,
    "page": 1,
    "pages": 1
  }
}