Deel Subpackage User API
The subpackage_user API from Deel — 1 operation(s) for subpackage_user.
The subpackage_user API from Deel — 1 operation(s) for subpackage_user.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/deel-com:deel-com-subpackage-user-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Endpoints Subpackage User API
version: 1.0.0
servers:
- url: https://api.letsdeel.com/rest/v2
- url: https://api-staging.letsdeel.com/rest/v2
tags:
- name: subpackage_user
paths:
/Users/{hris_profile_id}:
get:
operationId: retrieve-a-single-user-v-2026-01-01
summary: Retrieve a single User
description: 'Retrieve a single user by id.
**Token scopes**: `Users:read`'
tags:
- subpackage_user
parameters:
- name: hris_profile_id
in: path
description: The unique identifier (OID) of the HRIS profile to retrieve.
required: true
schema:
type: string
- name: Authorization
in: header
description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/User_retrieveASingleUser-v2026-01-01_Response_200'
'404':
description: Resource not found - The provided hrisProfileOid does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/RetrieveASingleUser-v2026-01-01RequestNotFoundError'
components:
schemas:
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItems:
type: object
properties:
team:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsTeam'
state:
type:
- string
- 'null'
title:
type:
- string
- 'null'
active:
type: boolean
default: false
country:
type:
- string
- 'null'
startDate:
type:
- string
- 'null'
contractId:
type: string
contractType:
type:
- string
- 'null'
customFields:
type: array
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItems'
description: Contract-level custom fields associated with the employment
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItems
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItems:
type: object
properties:
type:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItemsType'
value:
type: string
primary:
type: boolean
default: false
required:
- type
- value
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItems
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItemsType:
type: string
enum:
- home
- work
- other
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItemsType
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItems:
type: object
properties:
key:
type: string
path:
type: array
items:
type: string
type:
type: string
context:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItemsContext'
message:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItems
User_retrieveASingleUser-v2026-01-01_Response_200:
type: object
properties:
id:
type: string
meta:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMeta'
name:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaName'
title:
type: string
active:
type: boolean
default: false
emails:
type: array
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaEmailsItems'
schemas:
type: array
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaSchemasItems'
userName:
type: string
userType:
type: string
addresses:
type: array
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaAddressesItems'
urn:ietf:params:scim:schemas:extension:2.0:User:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20User'
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20User'
required:
- meta
- name
- emails
- schemas
- userName
title: User_retrieveASingleUser-v2026-01-01_Response_200
RetrieveASingleUser-v2026-01-01RequestNotFoundError:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItems'
request:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaRequest'
title: RetrieveASingleUser-v2026-01-01RequestNotFoundError
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaSchemasItems:
type: string
enum:
- urn:ietf:params:scim:schemas:core:2.0:User
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaSchemasItems
? UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItemsData
: type: object
properties: {}
description: The custom field value payload, structure varies by field type
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItemsData
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItemsContext:
type: object
properties: {}
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaErrorsItemsContext
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMetaResourceType:
type: string
enum:
- User
- Group
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMetaResourceType
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserCustomFieldsItems:
type: object
properties:
id:
type: string
name:
type:
- string
- 'null'
value:
type:
- string
- 'null'
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserCustomFieldsItems
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsTeam:
type: object
properties:
name:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsTeam
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMeta:
type: object
properties:
created:
type: string
format: date-time
location:
type: string
lastModified:
type: string
format: date-time
resourceType:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMetaResourceType'
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaMeta
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20User:
type: object
properties:
manager:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20UserManager'
costCenter:
type: string
department:
type: string
organization:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20User
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20UserManager:
type: object
properties:
value:
type: string
displayName:
type: string
required:
- value
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtensionEnterprise20UserManager
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate1:
type: string
enum:
- ''
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate1
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate:
oneOf:
- type: string
format: date-time
- $ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate1'
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaRequest:
type: object
properties:
url:
type: string
docs:
type: string
method:
type: string
source:
type: string
status:
type: integer
api_req_id:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaRequest
? UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItems
: type: object
properties:
id:
type: string
data:
oneOf:
- $ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItemsData'
- type: 'null'
description: The custom field value payload, structure varies by field type
name:
type: string
type:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItemsCustomFieldsItems
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaAddressesItems:
type: object
properties:
type:
type: string
region:
type: string
country:
type:
- string
- 'null'
locality:
type: string
postalCode:
type: string
streetAddress:
type: string
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaAddressesItems
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20User:
type: object
properties:
state:
type:
- string
- 'null'
country:
type:
- string
- 'null'
endDate:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEndDate'
isManager:
type: boolean
default: false
startDate:
type:
- string
- 'null'
format: date
employments:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserEmploymentsItems'
customFields:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20UserCustomFieldsItems'
hiringStatus:
type: string
workLocation:
type:
- string
- 'null'
description: The work location label assigned to the worker's HRIS profile
departmentHierarchy:
type:
- string
- 'null'
departmentExternalId:
type:
- string
- 'null'
departmentExternalIdHierarchy:
type:
- string
- 'null'
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaUrnIetfParamsScimSchemasExtension20User
UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaName:
type: object
properties:
givenName:
type: string
familyName:
type: string
required:
- givenName
- familyName
title: UsersHrisProfileIdGetResponsesContentApplicationJsonSchemaName
securitySchemes:
deelToken:
type: http
scheme: bearer
description: "## Authentication\nThe 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.\n\n```curl\ncurl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \\\n -H 'Authorization: Bearer YOUR-TOKEN-HERE'\n```\n\n[Learn more about authentication](/api/authentication)\n"
oauth2:
type: http
scheme: bearer
description: Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/