Retrieve a single User | Deel

curl https://api.letsdeel.com/rest/v2/Users/550e8400-e29b-41d4-a716-446655440000 \
     -H "Authorization: Bearer <token>"

{
  "meta": {
    "created": "2024-01-15T09:30:00Z",
    "location": "https://api.letsdeel.com/scim/v2/Users/550e8400-e29b-41d4-a716-446655440000",
    "lastModified": "2024-01-15T09:30:00Z",
    "resourceType": "User"
  },
  "name": {
    "givenName": "Alice",
    "familyName": "Johnson"
  },
  "emails": [
    {
      "type": "work",
      "value": "alice.johnson@deel.com",
      "primary": true
    }
  ],
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "alice.johnson@deel.com",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Senior Product Manager",
  "active": true,
  "userType": "employee",
  "addresses": [
    {
      "type": "work",
      "region": "CA",
      "country": "US",
      "locality": "San Francisco",
      "postalCode": "94105",
      "streetAddress": "123 Market St, Suite 400"
    }
  ],
  "urn:ietf:params:scim:schemas:extension:2.0:User": {
    "state": "CA",
    "country": "US",
    "endDate": "",
    "isManager": true,
    "startDate": "2022-06-01",
    "employments": [
      {
        "team": {
          "name": "Product Management"
        },
        "state": "CA",
        "title": "Senior Product Manager",
        "active": true,
        "country": "US",
        "startDate": "2022-06-01",
        "contractId": "c12345",
        "contractType": "full-time",
        "customFields": [
          {
            "id": "cf001",
            "data": {
              "value": "Agile Certified"
            },
            "name": "Certification",
            "type": "string"
          }
        ]
      }
    ],
    "customFields": [
      {
        "id": "cf002",
        "name": "Preferred Language",
        "value": "English"
      }
    ],
    "hiringStatus": "active",
    "workLocation": "San Francisco HQ",
    "departmentHierarchy": "Product / Management",
    "departmentExternalId": "dept-789",
    "departmentExternalIdHierarchy": "dept-100 / dept-789"
  },
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "manager": {
      "value": "b29a5ff0-bdb5-11ed-afa1-0242ac120002",
      "displayName": "Robert Smith"
    },
    "costCenter": "CC1001",
    "department": "Product",
    "organization": "Deel Inc"
  }
}

Retrieve a single user by id. Token scopes: Users: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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -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.letsdeel.com/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

hris_profile_idstringRequired

The unique identifier (OID) of the HRIS profile to retrieve.

Response

Successful response

metaobject

nameobject

emailslist of objects

schemaslist of enums

Allowed values:

userNamestring

idstring

titlestring

activebooleanDefaults to false

userTypestring

addresseslist of objects

urn:ietf:params:scim:schemas:extension:2.0:Userobject

urn:ietf:params:scim:schemas:extension:enterprise:2.0:Userobject

Errors

404

Not Found Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'