# Retrieve a student

`GET https://{domain}/api/v1/usuario/{usuario_email_id}`

Operation ID: `users.get` · API v1

Retrieves a student by ID, email or document.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `usuario_email_id` | path | string | yes | The student, by ID, email or document (CPF). A value that is a valid email is looked up by email; otherwise the digits are matched against the ID and the document. |

## Responses

### 200

The student.

Body: object.

### 401

The Authorization header is missing, or the key does not exist or was deleted.

Body: HandlerError.

### 404

No route matches the path, for example a non-numeric ID where a number is expected.

Body: HandlerError.

### 409

msg is E-mail inválido. (the identifier has @ but is not a valid email), O identificador fornecido é inválido. (no digits and not an email) or Usuário não encontrado.

Body: Error.

Full schema: https://cademi.dev/openapi/v1.json