v1

latestOpenAPI 3.1.02026-07-2498134321.1 KB

Users

List all Users

Documentation on listing Users via SCIM.

OAuth Scope required: scim.users.readUsers

get/Users

Query parameters

startIndexinteger

The starting index for retrieving this resource. Resources are indexed based on when they were first added to Ironclad.

countinteger

Specifies the maximum number of resources to return in a single page of results.

filterstring

Filters for identifying subsets of users. Filters must comply with the SCIM protocol's convention. For more details, see SCIM RFC 7644 Section 3.4.2.2.

excludedAttributesstring

A comma-separated list of attributes to exclude from the resources in the response.

Headers

x-as-user-emailstring

Example:jane.doe@test.com

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-id is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

x-as-user-idstring

Example:5f0375c4cdc1927a3c5edcd3

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-email is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

Response

200 OK

schemasstring[]

totalResultsinteger

The total number of users that match this filter. This may be larger than the number of users in this page, in which case pagination may be used to retrieve the next page of results.

startIndexinteger

The 1-based index of the first result in the current set of list results.

itemsPerPageinteger

Specifies the maximum number of resources that can be returned in a single page of results.

Example response

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 2,
  "Resources": [
    {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "userName": "alex.doe@example.com",
      "name": {
        "givenName": "Alex",
        "familyName": "Doe"
      },
      "title": "Vice President",
      "id": "6660d37dec0eac3deffb680e",
      "emails": [
        {
          "value": "alex.doe@example.com",
          "type": "work",
          "primary": true
        }
      ],
      "active": true,
      "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
        "department": "Legal"
      },
      "urn:ietf:params:scim:schemas:extension:ironclad:2.0:User": {
        "departmentHead": "jane.doe@test.com",
        "provider": "local"
      },
      "meta": {
        "resourceType": "User",
        "created": "2025-03-26T18:33:48.336Z",
        "lastModified": "2025-03-26T18:33:48.336Z",
        "location": "https://na1.ironcladapp.com/scim/v2/Users/67e4488c605caf0d8aa2e5c6"
      }
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 25
}