> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/falkor-dev-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/falkor-dev-docs/groups/status.md).

# Status

The [**status**](https://docs.falkor.io/groups/managing-users/tracking-activations) endpoint allows you to **search an array of emails** that returns each **email with the invite status** and **allocated groups**. If the email does not belong to any group(s), then this result is omitted.

In the example below, **"<test@example.com>"** is allocated to a group whereas **"<test2@example.com>"** is not.

### Parameters

| Key   | Type                            |
| ----- | ------------------------------- |
| email | Array of strings (valid emails) |

### Status Descriptions

| State        | Description                                                                                                                                              |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pending**  | User invite is pending but has not been sent.                                                                                                            |
| **Notified** | User invite has been sent.                                                                                                                               |
| **Active**   | User has activated their account on the app.                                                                                                             |
| **Nudged**   | User was [nudged](https://docs.falkor.io/groups/managing-users/sending-invites#invite-reminders) (reminder email sent 1 - 2 days before invite expires). |
| **Expired**  | User invite has [expired](https://docs.falkor.io/groups/managing-users/sending-invites#invite-expired) (28 days after being notified).                   |

### Example

```
curl -X POST \
  v1/groups/status \
  -H 'Authorization: Basic <Your Base64 Encoded Token>' \
  -d '{
	"email" : ["test@example.com","test2@example.com"]
}'
```

### Success Response

The response will contain an array of results, including the email, status, and group. The **email** is the provided email address, the **status** is the invite status of the user, and **groups** is a list of groups this user is in.

```
{
    "status": "success",
    "data": [
        {
            "email": "test@example.com",
            "status": "Notified",
            "groups": [
                "Group One",
                "Group Two",
                ...
            ]
        }
    ],
    "hash": "817f3aad61a810b1e8d7f7fb6303bdb2",
    "response_time": 0.08894681930541992
}
```