# Groups

## Get Cakes

<mark style="color:blue;">`GET`</mark> `https://staging.billeasy.in/api/customers/groups`

This endpoint allows you to get free cakes.

#### Headers

| Name              | Type   | Description                                                    |
| ----------------- | ------ | -------------------------------------------------------------- |
| Content-Type      | string |                                                                |
| x-customer-number | string |                                                                |
| x-customer-token  | string |                                                                |
| x-api-access      | string |                                                                |
| x-api-secret      | string | Authentication token to track down who is emptying our stocks. |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}
```
{
  "success": true,
  "msg": "groups",
  "data": [
    {
      "id": "11",
      "type": "groups",
      "attributes": {
        "name": "Billeasy E Solutions",
        "group_participants": [
          {
            "id": 35,
            "group_id": 11,
            "customer_id": 562,
            "phone": "9987180806",
            "name": "Riana",
            "is_admin": null,
            "status": null,
            "created_at": "2019-07-10T20:06:24.611+05:30",
            "updated_at": "2019-07-10T20:06:24.611+05:30"
          },
          {
            "id": 36,
            "group_id": 11,
            "customer_id": 551,
            "phone": "9892228599",
            "name": "Yash Thakur",
            "is_admin": true,
            "status": "accepted",
            "created_at": "2019-07-10T20:06:24.618+05:30",
            "updated_at": "2019-07-10T20:06:24.618+05:30"
          }
        ]
      }
    },
    {
      "id": "12",
      "type": "groups",
      "attributes": {
        "name": "Khana",
        "group_participants": [
          {
            "id": 37,
            "group_id": 12,
            "customer_id": 725,
            "phone": "9136702527",
            "name": "Aman Chaudhary",
            "is_admin": null,
            "status": null,
            "created_at": "2019-11-02T16:14:08.923+05:30",
            "updated_at": "2019-11-02T16:14:08.923+05:30"
          },
          {
            "id": 38,
            "group_id": 12,
            "customer_id": 551,
            "phone": "9892228599",
            "name": "Yash Thakur",
            "is_admin": true,
            "status": "accepted",
            "created_at": "2019-11-02T16:14:08.972+05:30",
            "updated_at": "2019-11-02T16:14:08.972+05:30"
          }
        ]
      }
    },
    {
      "id": "13",
      "type": "groups",
      "attributes": {
        "name": "Billeasy Android",
        "group_participants": [
          {
            "id": 39,
            "group_id": 13,
            "customer_id": 607,
            "phone": "9969330760",
            "name": "Anuj Billeasy",
            "is_admin": null,
            "status": null,
            "created_at": "2019-11-04T12:58:29.349+05:30",
            "updated_at": "2019-11-04T12:58:29.349+05:30"
          },
          {
            "id": 40,
            "group_id": 13,
            "customer_id": 551,
            "phone": "9892228599",
            "name": "Yash Thakur",
            "is_admin": true,
            "status": "accepted",
            "created_at": "2019-11-04T12:58:29.356+05:30",
            "updated_at": "2019-11-04T12:58:29.356+05:30"
          }
        ]
      }
    },
    {
      "id": "14",
      "type": "groups",
      "attributes": {
        "name": "Designer",
        "group_participants": [
          {
            "id": 41,
            "group_id": 14,
            "customer_id": 651,
            "phone": "9766329918",
            "name": "Vallabh Billeasy",
            "is_admin": null,
            "status": null,
            "created_at": "2019-11-04T17:15:19.807+05:30",
            "updated_at": "2019-11-04T17:15:19.807+05:30"
          },
          {
            "id": 42,
            "group_id": 14,
            "customer_id": 551,
            "phone": "9892228599",
            "name": "Yash Thakur",
            "is_admin": true,
            "status": "accepted",
            "created_at": "2019-11-04T17:15:19.813+05:30",
            "updated_at": "2019-11-04T17:15:19.813+05:30"
          }
        ]
      }
    }
  ]
}
```
{% endtab %}

{% tab title="404 Could not find a cake matching this query." %}
```
{ "success":false,   
  "msg": "group not found",
  "data":{}
}
```
{% endtab %}
{% endtabs %}

