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.

The sort field. Sorted by id desc by default.

Example:

To sort on users on the fields token_id on a descending order and email_stop on a ascending order:

...&sort=-token_id,email_stop

filter optional . Must be one of: id, login, email, created_at, updated_at, first_name, last_name, pool_year, pool_month, kind, status.

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)
  • first_name (standard field)
  • last_name (standard field)
  • pool_year (standard field)
  • pool_month (standard field)
  • kind (standard field)
  • status (standard field)
range optional . Must be one of: id, login, email, created_at, updated_at, first_name, last_name, 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
  • first_name
  • last_name
  • pool_year
  • pool_month
  • kind
  • status
comments powered by <span class='logo-disqus'>Disqus</span>
GET /v2/users
200
[
  {
    "id": 126,
    "login": "darthcae",
    "url": "https://api.intra.42.fr/v2/users/darthcae"
  },
  {
    "id": 125,
    "login": "sebulseb",
    "url": "https://api.intra.42.fr/v2/users/sebulseb"
  },
  {
    "id": 124,
    "login": "hsolo2",
    "url": "https://api.intra.42.fr/v2/users/hsolo2"
  }
]
curl  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/users"

[
  {
    "id": 126,
    "login": "darthcae",
    "url": "https://api.intra.42.fr/v2/users/darthcae"
  },
  {
    "id": 125,
    "login": "sebulseb",
    "url": "https://api.intra.42.fr/v2/users/sebulseb"
  },
  {
    "id": 124,
    "login": "hsolo2",
    "url": "https://api.intra.42.fr/v2/users/hsolo2"
  }
]
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"=>126, "login"=>"darthcae", "url"=>"https://api.intra.42.fr/v2/users/darthcae"}, {"id"=>125, "login"=>"sebulseb", "url"=>"https://api.intra.42.fr/v2/users/sebulseb"}, {"id"=>124, "login"=>"hsolo2", "url"=>"https://api.intra.42.fr/v2/users/hsolo2"}]