Get a specific contact
GET/api/v3/user/:user_id
Request
Responses
- 200
- 400
- 401
- 404
Object was fetched successfully
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
response
object
The user/contact ID #
External key value
Unique token
Customer portal username
First and last name of the contact
First name of contact
Middle name/initial
Last name
Suffix (e.g. "Jr.", "Sr.", "III", etc.)
(deprecated)
Title
E-mail address
Phone number
Mobile number
User type ID #
User type
The customer ID # this contact belongs to
Custom field #1
Custom field #2
Custom field #3
Custom field #4
Custom field #5
Custom field #6
Custom field #7
Custom field #8
Custom field #9
Custom field #10
Custom field #11
Custom field #12
Custom field #13
Custom field #14
Custom field #15
Custom field #16
Custom field #17
Custom field #18
Custom field #19
Custom field #20
Date/time the user/contact was created
Date/time the user/contact was last modified
URL for viewing the user/contact in the GUI
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": {
"user_id": 0,
"external_key": "string",
"token": "string",
"username": "string",
"name": "string",
"first_name": "string",
"middle_name_glob": "string",
"last_name": "string",
"name_suffix": "string",
"display_as": "string",
"title": "string",
"email": "string",
"phone": "string",
"mobile": "string",
"user_type_id": 0,
"user_type_name": "string",
"customer_id": 0,
"custom_1": "string",
"custom_2": "string",
"custom_3": "string",
"custom_4": "string",
"custom_5": "string",
"custom_6": "string",
"custom_7": "string",
"custom_8": "string",
"custom_9": "string",
"custom_10": "string",
"custom_11": "string",
"custom_12": "string",
"custom_13": "string",
"custom_14": "string",
"custom_15": "string",
"custom_16": "string",
"custom_17": "string",
"custom_18": "string",
"custom_19": "string",
"custom_20": "string",
"write_datetime": "string",
"mod_datetime": "string",
"url_self": "string"
}
}
{
"code": 200,
"status": "OK",
"message": "",
"response": {
"user_id": 362,
"external_key": null,
"first_name": "Keith",
"middle_name_glob": null,
"last_name": "Palmer",
"name_suffix": null,
"title": "",
"email": "keith@chargeover.com",
"phone": "860-634-1602",
"write_datetime": "2014-07-08 14:26:01",
"mod_datetime": "2014-07-08 14:26:01",
"name": "Keith Palmer",
"display_as": "Keith Palmer",
"user_type_id": 1,
"user_type_name": "Billing",
"username": "7yanhoctj6qs"
}
}
Bad request
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 400,
"status": "Error",
"message": "Missing or invalid parameter.",
"details": {},
"response": false
}
Authentication error
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 401,
"status": "Error",
"message": "Invalid or incorrect authorization [Missing (basic) authorization header.]",
"details": {},
"response": false
}
Object not found
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 404,
"status": "Error",
"message": "This object does not exist.",
"details": {},
"response": null
}