Get User by lookup key
GET/users/:lookupKey/:lookupValue
Use this endpoint to retrieve user details by lookup key. If multiple users with the same lookup key exist, use additional filtering depending on the lookup key to uniquely identify the user (e.g. source
and language
for lookup key source
).
Request
Path Parameters
Lookup key. Read more about user lookup keys
The value of the key (id or sourceId)
Query Parameters
Use expands
as a query parameter to fetch additional information for users like sources, parent, etc.
sources
: if the "expands" parameter contains this value, the response from the API will return additional source information descibing where this resource is imported from. If there are no sources for this resource then the sources
property in the response will be just an empty array.
parent
: use this value in the expands
query parameter to get additional information about the container which this resource belongs to. In this particular scenario the parent of a user can be a resource of type usergroup
Responses
- 200
- 400
- 404
Get User by id - 200 / Get User by lookup key - 200 (expands: sources, parent)
Response Headers
Connection
string
Content-Length
string
Date
string
Keep-Alive
string
Return-Format
string
- application/json
- Schema
- Example (from schema)
- Get User by id - 200
- Get User by lookup key - 200 (expands: sources, parent)
Schema
data
object
parent
object
{
"data": {
"abbreviation": "MM",
"company": "",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"id": 14760,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"parent": {
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"company": "Whitepaper Download",
"defaultobjectId": 221701,
"department": "",
"id": 119,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Whitepaper Download",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"sources": [],
"userManagerId": ""
},
"phone": "0032445888",
"sources": [],
"ssn": "",
"title": "Mr.",
"vatNumber": ""
},
"messages": [],
"total": 1
}
{
"data": {
"abbreviation": "MM",
"company": "",
"dateOfBirth": "August, 28 1993 00:00:00 +0000",
"debtorId": "12345",
"email": "miles@propel.us",
"firstName": "Miles",
"fullName": "Miles McCoy",
"gender": "M",
"id": 14760,
"lastName": "McCoy",
"login": "miles@propel.us",
"middleName": "",
"mobile": "0038975648",
"phone": "0032445888",
"ssn": "",
"title": "Mr.",
"vatNumber": ""
},
"messages": [],
"total": 1
}
{
"data": {
"abbreviation": "KP",
"company": "Propellor",
"dateOfBirth": "July, 22 1986 00:00:00 +0000",
"debtorId": "000002",
"email": "info@propellor.eu",
"firstName": "Karl",
"fullName": "Karl Pflieger",
"gender": "M",
"id": 14550,
"lastName": "Pflieger",
"login": "k.pflieger",
"middleName": "",
"mobile": "06123456789",
"parent": {
"authorizeId": "",
"budget": "N",
"budgetInherit": "Y",
"company": "Whitepaper Download",
"defaultobjectId": 221701,
"department": "",
"id": 119,
"inheritOrderList": "Y",
"inheritProductList": "Y",
"name": "Whitepaper Download",
"notes": "",
"office": "",
"orderListAllowAll": "U",
"orderListManagerId": "",
"sources": [],
"userManagerId": ""
},
"phone": "",
"sources": [],
"ssn": "",
"title": "Mr",
"vatNumber": ""
},
"messages": [],
"total": 1
}
Get User by ld - 400 (invalid lookupkey)
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Get User by ld - 400 (invalid lookupkey)
Schema
error
object
{
"error": {
"code": 10006,
"messages": [
"Invalid lookup key [id1], key must contain one of the following values: [id,sourceId]"
],
"moreInfo": "https://www.propel.us/docs/errors/10006",
"status": 400,
"type": "InvalidLookupKey"
}
}
{
"error": {
"code": 10006,
"messages": [
"Invalid lookup key [id1], key must contain one of the following values: [id,sourceId]"
],
"moreInfo": "https://www.propel.us/docs/errors/10006",
"status": 400,
"type": "InvalidLookupKey"
}
}
Get User by Id - 404
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Get User by Id - 404
Schema
error
object
{
"error": {
"code": 70006,
"messages": [
"User with id [146221] not found"
],
"moreInfo": "https://www.propel.us/docs/errors/70006",
"status": 404,
"type": "UserNotFound"
}
}
{
"error": {
"code": 70006,
"messages": [
"User with id [146221] not found"
],
"moreInfo": "https://www.propel.us/docs/errors/70006",
"status": 404,
"type": "UserNotFound"
}
}