GET /external/api/v3/user?name={name}

Get a single user by username.

Request Information

URI Parameters

NameDescriptionTypeAdditional informationNullable
name

string

Required

False

Body Parameters

None.

Response Information

Resource Description

UserModel
NameDescriptionTypeAdditional informationNullable
Roles

Collection of RoleModel

None

False
Username

string

Required

False
Type

Internal or external.

string

Required

False
HasSingleActiveRole

boolean

None

False

Response Formats

application/json, text/json

Sample:
{
  "Username": "sample string 1",
  "Roles": [
    {
      "Name": "sample string 1",
      "Id": "32995c79-a52b-41ee-8dd8-6f2ad5f49d37"
    },
    {
      "Name": "sample string 1",
      "Id": "32995c79-a52b-41ee-8dd8-6f2ad5f49d37"
    }
  ],
  "Type": "sample string 2",
  "HasSingleActiveRole": true
}

application/xml, text/xml

Sample:
<UserModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.V1.Models">
  <HasSingleActiveRole xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">true</HasSingleActiveRole>
  <Type xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">sample string 2</Type>
  <Username xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">sample string 1</Username>
  <Roles xmlns:d2p1="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">
    <d2p1:RoleModel>
      <d2p1:Id>32995c79-a52b-41ee-8dd8-6f2ad5f49d37</d2p1:Id>
      <d2p1:Name>sample string 1</d2p1:Name>
    </d2p1:RoleModel>
    <d2p1:RoleModel>
      <d2p1:Id>32995c79-a52b-41ee-8dd8-6f2ad5f49d37</d2p1:Id>
      <d2p1:Name>sample string 1</d2p1:Name>
    </d2p1:RoleModel>
  </Roles>
</UserModel>

Response Status Codes

Status Code Name Description
200 OK The request has succeeded.
400 Bad Request Fulfilling the request would cause an invalid state. Request needs modification.
401 Unauthorized Missing or invalid authentication token.
403 Forbidden Server refuses to authorize the request.
408 Request Timeout The server timed out waiting for the request.
429 Too Many Requests Too many requests in a given amount of time.
500 Internal Server Error The server encountered an unexpected condition which prevented it from fulfilling the request.
503 Service Unavailable The server is unable to proces the request at the moment, try again later.