Description
This API will return the Hi Marley Operator associated with the passed ID.
| Service Name | Get Operator by Email |
| Service Type | REST |
| Method | GET |
| UAT (Sandbox) URL | https://integration.uat.marley.ai/api/v2/operators/:id |
| Production URL | https://integration.himarley.io/api/v2/operators/:id |
| Technical Documentation | View technical documentation with sample request and response payloads hosted on Postman. |
Table of Contents
API Request
Flow
- Send API request with the operator ID as a path parameter.
- Hi Marley receives the request and validates an operator exists with the passed ID.
- Hi Marley responds with the operator's object data.
Request Example
https://integration.uat.marley.ai/api/v2/operators/bc13bc97-23eb-40eb-ac0f-12341ee99aae
Request Path Breakdown
| Property | Description | Type | Required | Example | Validation |
| id | The id of the operator. | string | true |
"bc13bc97-23eb-40eb-ac0f-12341ee99aae"
|
|
API Response
Response Payload Example
{
"id": "bc13bc97-23eb-40eb-ac0f-12341ee99aae",
"firstName": "James",
"lastName": "Zimmerman",
"email": "james.zimmerman@himarley.com",
"mobile": "8449627539",
"title": "operator",
"roles": [
"OPERATOR"
]
}Response Fields Breakdown
| Element | Description | Type | Required | Example |
| id | The identifier generated and assigned to the operator. | string | true | "id": "14db69c0-af9c-41a4-a9e9-403d4b6898ae1" |
| firstName | The operators given name. | string | true | "first": "James" |
| lastName | The operators surname. | string | true | "last": "Zimmerman" |
| The operators email address. | string | true | "email": "james.zimmerman@himarley.com" | |
| mobile | The operators mobile number. | int | false | "mobile": "5552325555" |
title |
The operators title. |
string |
false |
"title": "operator" |
| role | The operators role. | enum | true | "role": "operator" |
Comments
0 comments
Please sign in to leave a comment.