Skip to main content

Get User (SCIM)

Get a user by ID using SCIM 2.0 protocol.

Endpoint​

GET /scim/v2/Users/{user_id}

Headers​

HeaderRequiredDescription
AuthorizationYesBearer <scim_bearer_token>
AcceptYesapplication/scim+json or application/json

Path Parameters​

ParameterTypeRequiredDescription
user_idstringYesUser ID

Response​

Success (200)​

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "123",
  "userName": "user@example.com",
  "name": {
    "formatted": "John Doe",
    "familyName": "Doe",
    "givenName": "John"
  },
  "active": true,
  "emails": [
    {
      "value": "user@example.com",
      "primary": true
    }
  ],
  "meta": {
    "resourceType": "User",
    "created": "2024-01-01T12:00:00Z",
    "lastModified": "2024-01-01T12:00:00Z",
    "location": "/scim/v2/Users/123"
  }
}

Error (404)​

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "detail": "User not found",
  "status": "404",
  "scimType": "uniqueness"
}

Features​

  • SCIM 2.0 compliant
  • Returns user in SCIM format
  • User must belong to the organization associated with the bearer token

Example​

curl -X GET "https://api.rivergen.com/scim/v2/Users/123" \
  -H "Authorization: Bearer <scim_bearer_token>" \
  -H "Accept: application/scim+json"