List users assigned to an IT policy | Deel

curl -G https://api.letsdeel.com/rest/it/policies/550e8400-e29b-41d4-a716-446655440000/users \
     -H "Authorization: Bearer <token>" \
     -d cursor=d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m \
     -d limit=10 \
     -d hris_profile_id=550e8400-e29b-41d4-a716-446655440000

{
  "data": [
    {
      "emails": [
        "bruce.wayne@wayne-enterprise.com",
        "batman@gotham.com"
      ],
      "address": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "city": "Gotham",
        "type": "DELIVERY",
        "line1": "1007 Mountain Drive",
        "line2": "Stately Wayne Manor",
        "state": "New Jersey",
        "country": "US",
        "is_valid": true,
        "post_code": "12345",
        "phone_number": "+1-212-456-7890",
        "date_of_birth": "1997-12-18",
        "tax_id_number": "BAT123456",
        "passport_number": "P123456789",
        "delivery_instructions": "Use the Bat-Signal if urgent"
      },
      "last_name": "Wayne",
      "first_name": "Bruce",
      "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "has_more": true,
  "next_cursor": "d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m",
  "total_count": 133
}

Lists the workers assigned to one of your organization’s IT hardware policies. Use it to resolve which workers a policy applies to before raising equipment requests on their behalf, or to audit policy membership. Results are cursor-paginated.

Token scopes: it-policies:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

policy_idstringRequiredformat: "uuid"

IT policy identifier

Query parameters

cursorstringOptional

Indicates where the next page of results starts, as returned in a paginated list response

limitintegerOptional1-100Defaults to 20

Return a page of results with given number of records

hris_profile_idstringOptionalformat: "uuid"

Filter by the worker's HRIS Profile ID, to find which policy a specific worker is attached to. Repeat the key to filter on multiple values.

Response

datalist of objects

has_moreboolean

Whether there are more results available

next_cursorstring or null

Cursor to the next page

total_countlong

Total number of records

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'