GET /v2/coalitions/:coalition_id/users
Return all the users of the given Coalition
GET /v2/dashes/:dash_id/users
Return all the users of the given Dash
GET /v2/events/:event_id/users
Return all the users of the given Event
GET /v2/accreditations/:accreditation_id/users
Return all the users of the given Accreditation
GET /v2/teams/:team_id/users
Return all the users of the given Team
GET /v2/projects/:project_id/users
Return all the users of the given Project
GET /v2/partnerships/:partnership_id/users
Return all the users of the given Partnership
GET /v2/expertises/:expertise_id/users
Return all the users of the given Expertise
GET /v2/users
Return all the users
GET /v2/cursus/:cursus_id/users
Return all the users of the given Cursus
GET /v2/campus/:campus_id/users
Return all the users of the given Campus
GET /v2/achievements/:achievement_id/users
Return all the users of the given Achievement
GET /v2/titles/:title_id/users
Return all the users of the given Title
GET /v2/quests/:quest_id/users
Return all the users of the given Quest
GET /v2/groups/:group_id/users
Return all the users of the given Group
settings Params
Param name | Description |
---|---|
coalition_id |
optional
. Must be String
The coalition id or slug |
dash_id |
optional
. Must be String
The dash id or slug |
event_id |
optional
. Must be String
The event id |
accreditation_id |
optional
. Must be String
The accreditation id |
team_id |
optional
. Must be String
The team id |
project_id |
optional
. Must be String
The project id or slug |
partnership_id |
optional
. Must be String
The partnership id or slug |
expertise_id |
optional
. Must be String
The expertise id or slug |
cursus_id |
optional
. Must be String
The cursus id or slug |
campus_id |
optional
. Must be String
The campus id or slug |
achievement_id |
optional
. Must be String
The achievement id or slug |
title_id |
optional
. Must be String
The title id or slug |
quest_id |
optional
. Must be String
The quest id or slug |
group_id |
optional
. Must be String
The group id |
sort |
optional
. Must be one of: id , login , email , encrypted_password , reset_password_token , reset_password_sent_at , created_at , updated_at , image , first_name , last_name , pool_year , pool_month , kind , status , otp_secret_key , otp_tmp , otp_activated , otp_backup_passwords , slack_team , slack_login , slack_mail , slack_code_validation , slack_validated_at , token_id , email_stop , linked_user_id , usual_first_name , last_seen_at , password_changed_at , encrypted_single_usage_password , first_warn_anon_sent_at , second_warn_anon_sent_at , alumnized_at .
The sort field. Sorted by id desc by default. MoreExample:To sort on users on the fields second_warn_anon_sent_at on a descending order and alumnized_at on a ascending order: ...&sort=-second_warn_anon_sent_at,alumnized_at |
filter |
optional
. Must be one of: id , login , email , created_at , updated_at , pool_year , pool_month , kind , status , primary_campus_id , first_name , last_name , alumni? , staff? .
Filtering on one or more fields MoreExample:
To filter on users with the
...&filter[id]=a_value,another_value Filterable fields:
|
range |
optional
. Must be one of: id , login , email , created_at , updated_at , pool_year , pool_month , kind , status .
Select on a particular range MoreExample:
To range on users with the
...&range[status]=min_value,max_value Rangeable fields:
|
Examples
GET /v2/users
200
[
{
"id": 39962,
"email": "[email protected]",
"login": "malallai",
"first_name": "Malo",
"last_name": "Allain",
"usual_full_name": "Malo Allain",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/malallai",
"phone": "hidden",
"displayname": "Malo Allain",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/39a641ed152b654cfbff5c5864eb05c1/malallai.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/a818d7a54298d333411557d0b55b61b3/large_malallai.jpg",
"medium": "https://cdn.intra.42.fr/users/53691acd1e0ea75b782ddbe121c17423/medium_malallai.jpg",
"small": "https://cdn.intra.42.fr/users/617de91b59fd7e59ecaf6470a4b37645/small_malallai.jpg",
"micro": "https://cdn.intra.42.fr/users/6f74b46e2016b0e6c41fa05b5952e17c/micro_malallai.jpg"
}
},
"staff?": false,
"correction_point": 4,
"pool_month": "august",
"pool_year": "2018",
"location": null,
"wallet": 290,
"anonymize_date": "2025-10-24T00:00:00.000+02:00",
"data_erasure_date": "2025-10-24T00:00:00.000+02:00",
"created_at": "2018-07-17T08:57:33.128Z",
"updated_at": "2022-09-27T18:48:28.207Z",
"alumnized_at": null,
"alumni?": false,
"active?": true
},
{
"id": 26134,
"email": "[email protected]",
"login": "asandolo",
"first_name": "Alexandre",
"last_name": "Sandolo",
"usual_full_name": "Alexandre Sandolo",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/asandolo",
"phone": "hidden",
"displayname": "Alexandre Sandolo",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/e6ad4cc0cd6b69c9f18cf7fb8fefda22/asandolo.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/5100f27887ee3dc6c864b618ddb44b1f/large_asandolo.jpg",
"medium": "https://cdn.intra.42.fr/users/df044745577b908566f1cdca3e927c23/medium_asandolo.jpg",
"small": "https://cdn.intra.42.fr/users/2946d4da689a314b6ef6f090ce724a1b/small_asandolo.jpg",
"micro": "https://cdn.intra.42.fr/users/ff75319aa7fa4332336edf9216c51e0d/micro_asandolo.jpg"
}
},
"staff?": false,
"correction_point": 4,
"pool_month": "july",
"pool_year": "2017",
"location": null,
"wallet": 1776,
"anonymize_date": "2025-10-11T00:00:00.000+02:00",
"data_erasure_date": "2025-10-11T00:00:00.000+02:00",
"created_at": "2017-06-22T11:42:39.426Z",
"updated_at": "2022-09-27T19:20:19.605Z",
"alumnized_at": null,
"alumni?": false,
"active?": true
},
{
"id": 20152,
"email": "[email protected]",
"login": "clabouri",
"first_name": "Charles",
"last_name": "Labourier",
"usual_full_name": "Charles Labourier",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/clabouri",
"phone": "hidden",
"displayname": "Charles Labourier",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/17dd9c4ee21baf1e2b259e8de08adee2/clabouri.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/d310252790c850b2fa3158ad4d97ac17/large_clabouri.jpg",
"medium": "https://cdn.intra.42.fr/users/07b3b6ef492df6ed2148b5c6f4fb5f7d/medium_clabouri.jpg",
"small": "https://cdn.intra.42.fr/users/a28d995d70d99b439cbcf38852b197a1/small_clabouri.jpg",
"micro": "https://cdn.intra.42.fr/users/de2ebeba74c5ff018f47f124cb84568b/micro_clabouri.jpg"
}
},
"staff?": false,
"correction_point": 3,
"pool_month": "august",
"pool_year": "2016",
"location": null,
"wallet": 525,
"anonymize_date": null,
"data_erasure_date": null,
"created_at": "2016-07-19T15:43:15.282Z",
"updated_at": "2022-09-19T15:36:06.910Z",
"alumnized_at": "2021-09-28T17:06:21.597Z",
"alumni?": true,
"active?": true
},
{
"id": 14819,
"email": "[email protected]",
"login": "nkrouglo",
"first_name": "Natalia",
"last_name": "Krouglov",
"usual_full_name": "Natalia Krouglov",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/nkrouglo",
"phone": "hidden",
"displayname": "Natalia Krouglov",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/04fc6c399a81d114bd479dc3a5b90ea4/nkrouglo.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/594b01edc55f87bf4918a861823cc448/large_nkrouglo.jpg",
"medium": "https://cdn.intra.42.fr/users/3b1dc67a9b58c7e8b8bd072fa9c4aa6e/medium_nkrouglo.jpg",
"small": "https://cdn.intra.42.fr/users/2a8263df5f95515917148068fa82eb3f/small_nkrouglo.jpg",
"micro": "https://cdn.intra.42.fr/users/7e52b8f556ada1e2cf23d5c6d6515094/micro_nkrouglo.jpg"
}
},
"staff?": false,
"correction_point": 3,
"pool_month": "july",
"pool_year": "2015",
"location": null,
"wallet": 240,
"anonymize_date": "2024-01-08T00:00:00.000+01:00",
"data_erasure_date": "2024-01-08T00:00:00.000+01:00",
"created_at": "2016-01-20T00:38:39.938Z",
"updated_at": "2022-09-19T15:35:56.534Z",
"alumnized_at": null,
"alumni?": false,
"active?": false
}
]
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/users"
[
{
"id": 39962,
"email": "[email protected]",
"login": "malallai",
"first_name": "Malo",
"last_name": "Allain",
"usual_full_name": "Malo Allain",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/malallai",
"phone": "hidden",
"displayname": "Malo Allain",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/39a641ed152b654cfbff5c5864eb05c1/malallai.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/a818d7a54298d333411557d0b55b61b3/large_malallai.jpg",
"medium": "https://cdn.intra.42.fr/users/53691acd1e0ea75b782ddbe121c17423/medium_malallai.jpg",
"small": "https://cdn.intra.42.fr/users/617de91b59fd7e59ecaf6470a4b37645/small_malallai.jpg",
"micro": "https://cdn.intra.42.fr/users/6f74b46e2016b0e6c41fa05b5952e17c/micro_malallai.jpg"
}
},
"staff?": false,
"correction_point": 4,
"pool_month": "august",
"pool_year": "2018",
"location": null,
"wallet": 290,
"anonymize_date": "2025-10-24T00:00:00.000+02:00",
"data_erasure_date": "2025-10-24T00:00:00.000+02:00",
"created_at": "2018-07-17T08:57:33.128Z",
"updated_at": "2022-09-27T18:48:28.207Z",
"alumnized_at": null,
"alumni?": false,
"active?": true
},
{
"id": 26134,
"email": "[email protected]",
"login": "asandolo",
"first_name": "Alexandre",
"last_name": "Sandolo",
"usual_full_name": "Alexandre Sandolo",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/asandolo",
"phone": "hidden",
"displayname": "Alexandre Sandolo",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/e6ad4cc0cd6b69c9f18cf7fb8fefda22/asandolo.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/5100f27887ee3dc6c864b618ddb44b1f/large_asandolo.jpg",
"medium": "https://cdn.intra.42.fr/users/df044745577b908566f1cdca3e927c23/medium_asandolo.jpg",
"small": "https://cdn.intra.42.fr/users/2946d4da689a314b6ef6f090ce724a1b/small_asandolo.jpg",
"micro": "https://cdn.intra.42.fr/users/ff75319aa7fa4332336edf9216c51e0d/micro_asandolo.jpg"
}
},
"staff?": false,
"correction_point": 4,
"pool_month": "july",
"pool_year": "2017",
"location": null,
"wallet": 1776,
"anonymize_date": "2025-10-11T00:00:00.000+02:00",
"data_erasure_date": "2025-10-11T00:00:00.000+02:00",
"created_at": "2017-06-22T11:42:39.426Z",
"updated_at": "2022-09-27T19:20:19.605Z",
"alumnized_at": null,
"alumni?": false,
"active?": true
},
{
"id": 20152,
"email": "[email protected]",
"login": "clabouri",
"first_name": "Charles",
"last_name": "Labourier",
"usual_full_name": "Charles Labourier",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/clabouri",
"phone": "hidden",
"displayname": "Charles Labourier",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/17dd9c4ee21baf1e2b259e8de08adee2/clabouri.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/d310252790c850b2fa3158ad4d97ac17/large_clabouri.jpg",
"medium": "https://cdn.intra.42.fr/users/07b3b6ef492df6ed2148b5c6f4fb5f7d/medium_clabouri.jpg",
"small": "https://cdn.intra.42.fr/users/a28d995d70d99b439cbcf38852b197a1/small_clabouri.jpg",
"micro": "https://cdn.intra.42.fr/users/de2ebeba74c5ff018f47f124cb84568b/micro_clabouri.jpg"
}
},
"staff?": false,
"correction_point": 3,
"pool_month": "august",
"pool_year": "2016",
"location": null,
"wallet": 525,
"anonymize_date": null,
"data_erasure_date": null,
"created_at": "2016-07-19T15:43:15.282Z",
"updated_at": "2022-09-19T15:36:06.910Z",
"alumnized_at": "2021-09-28T17:06:21.597Z",
"alumni?": true,
"active?": true
},
{
"id": 14819,
"email": "[email protected]",
"login": "nkrouglo",
"first_name": "Natalia",
"last_name": "Krouglov",
"usual_full_name": "Natalia Krouglov",
"usual_first_name": null,
"url": "https://api.intra.42.fr/v2/users/nkrouglo",
"phone": "hidden",
"displayname": "Natalia Krouglov",
"kind": "student",
"image": {
"link": "https://cdn.intra.42.fr/users/04fc6c399a81d114bd479dc3a5b90ea4/nkrouglo.jpg",
"versions": {
"large": "https://cdn.intra.42.fr/users/594b01edc55f87bf4918a861823cc448/large_nkrouglo.jpg",
"medium": "https://cdn.intra.42.fr/users/3b1dc67a9b58c7e8b8bd072fa9c4aa6e/medium_nkrouglo.jpg",
"small": "https://cdn.intra.42.fr/users/2a8263df5f95515917148068fa82eb3f/small_nkrouglo.jpg",
"micro": "https://cdn.intra.42.fr/users/7e52b8f556ada1e2cf23d5c6d6515094/micro_nkrouglo.jpg"
}
},
"staff?": false,
"correction_point": 3,
"pool_month": "july",
"pool_year": "2015",
"location": null,
"wallet": 240,
"anonymize_date": "2024-01-08T00:00:00.000+01:00",
"data_erasure_date": "2024-01-08T00:00:00.000+01:00",
"created_at": "2016-01-20T00:38:39.938Z",
"updated_at": "2022-09-19T15:35:56.534Z",
"alumnized_at": null,
"alumni?": false,
"active?": false
}
]
require "oauth2"
UID = "Your application uid"
SECRET = "Your application secret"
client = OAuth2::Client.new(UID, SECRET, site: "https://api.intra.42.fr")
token = client.client_credentials.get_token
response = token.get("/v2/users")
response.status
# => 200
response.parsed
# => [{"id"=>39962, "email"=>"[email protected]", "login"=>"malallai", "first_name"=>"Malo", "last_name"=>"Allain", "usual_full_name"=>"Malo Allain", "usual_first_name"=>nil, "url"=>"https://api.intra.42.fr/v2/users/malallai", "phone"=>"hidden", "displayname"=>"Malo Allain", "kind"=>"student", "image"=>{"link"=>"https://cdn.intra.42.fr/users/39a641ed152b654cfbff5c5864eb05c1/malallai.jpg", "versions"=>{"large"=>"https://cdn.intra.42.fr/users/a818d7a54298d333411557d0b55b61b3/large_malallai.jpg", "medium"=>"https://cdn.intra.42.fr/users/53691acd1e0ea75b782ddbe121c17423/medium_malallai.jpg", "small"=>"https://cdn.intra.42.fr/users/617de91b59fd7e59ecaf6470a4b37645/small_malallai.jpg", "micro"=>"https://cdn.intra.42.fr/users/6f74b46e2016b0e6c41fa05b5952e17c/micro_malallai.jpg"}}, "staff?"=>false, "correction_point"=>4, "pool_month"=>"august", "pool_year"=>"2018", "location"=>nil, "wallet"=>290, "anonymize_date"=>"2025-10-24T00:00:00.000+02:00", "data_erasure_date"=>"2025-10-24T00:00:00.000+02:00", "created_at"=>"2018-07-17T08:57:33.128Z", "updated_at"=>"2022-09-27T18:48:28.207Z", "alumnized_at"=>nil, "alumni?"=>false, "active?"=>true}, {"id"=>26134, "email"=>"[email protected]", "login"=>"asandolo", "first_name"=>"Alexandre", "last_name"=>"Sandolo", "usual_full_name"=>"Alexandre Sandolo", "usual_first_name"=>nil, "url"=>"https://api.intra.42.fr/v2/users/asandolo", "phone"=>"hidden", "displayname"=>"Alexandre Sandolo", "kind"=>"student", "image"=>{"link"=>"https://cdn.intra.42.fr/users/e6ad4cc0cd6b69c9f18cf7fb8fefda22/asandolo.jpg", "versions"=>{"large"=>"https://cdn.intra.42.fr/users/5100f27887ee3dc6c864b618ddb44b1f/large_asandolo.jpg", "medium"=>"https://cdn.intra.42.fr/users/df044745577b908566f1cdca3e927c23/medium_asandolo.jpg", "small"=>"https://cdn.intra.42.fr/users/2946d4da689a314b6ef6f090ce724a1b/small_asandolo.jpg", "micro"=>"https://cdn.intra.42.fr/users/ff75319aa7fa4332336edf9216c51e0d/micro_asandolo.jpg"}}, "staff?"=>false, "correction_point"=>4, "pool_month"=>"july", "pool_year"=>"2017", "location"=>nil, "wallet"=>1776, "anonymize_date"=>"2025-10-11T00:00:00.000+02:00", "data_erasure_date"=>"2025-10-11T00:00:00.000+02:00", "created_at"=>"2017-06-22T11:42:39.426Z", "updated_at"=>"2022-09-27T19:20:19.605Z", "alumnized_at"=>nil, "alumni?"=>false, "active?"=>true}, {"id"=>20152, "email"=>"[email protected]", "login"=>"clabouri", "first_name"=>"Charles", "last_name"=>"Labourier", "usual_full_name"=>"Charles Labourier", "usual_first_name"=>nil, "url"=>"https://api.intra.42.fr/v2/users/clabouri", "phone"=>"hidden", "displayname"=>"Charles Labourier", "kind"=>"student", "image"=>{"link"=>"https://cdn.intra.42.fr/users/17dd9c4ee21baf1e2b259e8de08adee2/clabouri.jpg", "versions"=>{"large"=>"https://cdn.intra.42.fr/users/d310252790c850b2fa3158ad4d97ac17/large_clabouri.jpg", "medium"=>"https://cdn.intra.42.fr/users/07b3b6ef492df6ed2148b5c6f4fb5f7d/medium_clabouri.jpg", "small"=>"https://cdn.intra.42.fr/users/a28d995d70d99b439cbcf38852b197a1/small_clabouri.jpg", "micro"=>"https://cdn.intra.42.fr/users/de2ebeba74c5ff018f47f124cb84568b/micro_clabouri.jpg"}}, "staff?"=>false, "correction_point"=>3, "pool_month"=>"august", "pool_year"=>"2016", "location"=>nil, "wallet"=>525, "anonymize_date"=>nil, "data_erasure_date"=>nil, "created_at"=>"2016-07-19T15:43:15.282Z", "updated_at"=>"2022-09-19T15:36:06.910Z", "alumnized_at"=>"2021-09-28T17:06:21.597Z", "alumni?"=>true, "active?"=>true}, {"id"=>14819, "email"=>"[email protected]", "login"=>"nkrouglo", "first_name"=>"Natalia", "last_name"=>"Krouglov", "usual_full_name"=>"Natalia Krouglov", "usual_first_name"=>nil, "url"=>"https://api.intra.42.fr/v2/users/nkrouglo", "phone"=>"hidden", "displayname"=>"Natalia Krouglov", "kind"=>"student", "image"=>{"link"=>"https://cdn.intra.42.fr/users/04fc6c399a81d114bd479dc3a5b90ea4/nkrouglo.jpg", "versions"=>{"large"=>"https://cdn.intra.42.fr/users/594b01edc55f87bf4918a861823cc448/large_nkrouglo.jpg", "medium"=>"https://cdn.intra.42.fr/users/3b1dc67a9b58c7e8b8bd072fa9c4aa6e/medium_nkrouglo.jpg", "small"=>"https://cdn.intra.42.fr/users/2a8263df5f95515917148068fa82eb3f/small_nkrouglo.jpg", "micro"=>"https://cdn.intra.42.fr/users/7e52b8f556ada1e2cf23d5c6d6515094/micro_nkrouglo.jpg"}}, "staff?"=>false, "correction_point"=>3, "pool_month"=>"july", "pool_year"=>"2015", "location"=>nil, "wallet"=>240, "anonymize_date"=>"2024-01-08T00:00:00.000+01:00", "data_erasure_date"=>"2024-01-08T00:00:00.000+01:00", "created_at"=>"2016-01-20T00:38:39.938Z", "updated_at"=>"2022-09-19T15:35:56.534Z", "alumnized_at"=>nil, "alumni?"=>false, "active?"=>false}]