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.

Example:

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

Example:

To filter on users with the id field matching a_value or another_value:

...&filter[id]=a_value,another_value

Filterable fields:
  • id (standard field)
  • login (standard field)
  • email (standard field)
  • created_at (standard field)
  • updated_at (standard field)
  • pool_year (standard field)
  • pool_month (standard field)
  • kind (standard field)
  • status (standard field)
  • primary_campus_id : .
  • first_name : .
  • last_name : .
  • alumni? : .
  • staff? : .
range optional . Must be one of: id, login, email, created_at, updated_at, pool_year, pool_month, kind, status.

Select on a particular range

Example:

To range on users with the status field between min_value and max_value:

...&range[status]=min_value,max_value

Rangeable fields:
  • id
  • login
  • email
  • created_at
  • updated_at
  • pool_year
  • pool_month
  • kind
  • status
GET /v2/users
200
[
  {
    "id": 39962,
    "email": "malallai@student.42.fr",
    "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": "asandolo@student.42.fr",
    "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": "clabouri@student.42.fr",
    "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": "nkrouglo@student.42.fr",
    "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": "malallai@student.42.fr",
    "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": "asandolo@student.42.fr",
    "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": "clabouri@student.42.fr",
    "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": "nkrouglo@student.42.fr",
    "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"=>"malallai@student.42.fr", "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"=>"asandolo@student.42.fr", "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"=>"clabouri@student.42.fr", "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"=>"nkrouglo@student.42.fr", "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}]