# Registered users

This service returns the list of all the users [registered](https://docs.drivequant.com/backend/definitions#registered) for the challenge.

Since a user can register before the start date of a challenge, this service can help you partition your users between those who registered and those who did not. This can provide you with a simple way of notifying users who have not yet registered, or who have forgotten to register.

{% hint style="info" %}
If you have your **admin API key**, you can try the API via this [**link**](https://drivequant.stoplight.io/docs/drivequant-public/6edd14c795f04-list-all-registered-users).
{% endhint %}

{% openapi src="<https://2525923625-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXYIG5U3AO65YYFWJRK%2Fuploads%2FN7KAiaeCZUgSyP3ciH8Y%2Fdrivekit-admin-challenge-v3.yml?alt=media&token=8308057e-25b8-4b42-8b57-aab662abd6b5>" path="/drivekit/admin/challenges/{challengeId}/registered" method="get" %}
[drivekit-admin-challenge-v3.yml](https://2525923625-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXYIG5U3AO65YYFWJRK%2Fuploads%2FN7KAiaeCZUgSyP3ciH8Y%2Fdrivekit-admin-challenge-v3.yml?alt=media\&token=8308057e-25b8-4b42-8b57-aab662abd6b5)
{% endopenapi %}

***

## Response

The table below summarizes the elements included in the `RegisteredUsersResponse` object.

<table><thead><tr><th width="217.66666666666666">Field</th><th width="193">Type</th><th>Description</th></tr></thead><tbody><tr><td>challengeId</td><td><code>string</code></td><td>Unique identifier of the challenge</td></tr><tr><td>status</td><td><code>string</code></td><td>Status of the users in the challenge<br><em>Possible values: <code>ALL</code>, <code>RANKED</code>, <code>NOT_RANKED</code></em></td></tr><tr><td>count</td><td><code>int</code></td><td>Total number of users with the given status</td></tr><tr><td>users</td><td><code>array[object]</code></td><td>List of users with the given status <em>(see</em> <a href="#userinfo"><em>UserInfo</em></a><em>)</em></td></tr></tbody></table>

### UserInfo

The table below summarizes the elements included in the `UserInfo` object.

<table><thead><tr><th width="217.66666666666666">Field</th><th width="150">Type</th><th>Description</th></tr></thead><tbody><tr><td>username</td><td><code>string</code></td><td>Unique identifier of the user</td></tr><tr><td>firstname</td><td><code>string</code></td><td>First name of the user</td></tr><tr><td>lastname</td><td><code>string</code></td><td>Last name of the user</td></tr><tr><td>registerDate</td><td><code>string</code></td><td>Date at which the user entered the challenge<br><em>Date format: <code>YYYY-MM-dd’T’HH:mm:ss.SSSZ</code></em></td></tr></tbody></table>