> ## Documentation Index
> Fetch the complete documentation index at: https://www.help.creatora.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Find a Student

> Look up an existing Student and keep the ID for an access workflow.

Use the Student's email to find the account ID needed for a controlled access grant. Send your [Administrator headers](/en/api/api-conventions#requests-and-access-mode).

```graphql theme={null}
query FindStudent($email: String!) {
  students(email: { equals: $email }, pagination: { limit: 2 }) {
    id
    email
    role
  }
}
```

```json theme={null}
{ "email": "student@example.com" }
```

Compare the returned email and role with the intended account before keeping its `id` as `studentId`. Proceed only when you have identified one existing account with the `student` role. The filter narrows the results; it is not a substitute for checking the returned account.

See the [`students` query reference](/en/api/reference/queries/students) for the supported filter and return fields.
