GET person/get?PersonId={PersonId}&Token={Token}

Retrieve personal data for specific person. Application privilege "View" for licensed agenda "Persons" required. Data may also be restricted by record permission "View" of agenda "Persons"

Request Information

Authorization

  • Authorization by token required

Availability

  • Method can be used

URI Parameters

NameDescriptionTypeAdditional information
PersonId

Unique identification of the person in the system

 string

Required

String length: inclusive between 0 and 100
Token

The action is authorized by this token. Token should generated by calling action "POST login". Expiration time of each token is 20 seconds

 globally unique identifier

Required

Body Parameters

None.

Response Information

Response Codes

Http CodeError NumberDescription
200 request succesfully done 0 Successfully done
400 bad request 1002 Entry parameter missing or parameter bindigs failed
401 unauthorized 1000 Token {0} not found
401 unauthorized 1001 Token {0} already expired
401 unauthorized 1006 Ip filter violated for ip client address [{0}]
401 unauthorized 1007 Ip filter [{0}] parsing failed
401 unauthorized 1008 Request rate policy violated for [{0}]
403 server refuses fo fulfill the request 1101 Application privilege View for licensed agenda Persons violated for person [{0}]
404 required resource does not exist on the server 1100 PersonId [{0}] not found
415 unsupported Media Type The request entity has a media type which the server or resource does not support. Only application/json and application/xml are supported
500 internal error Server exception description

Resource Description

PersonGetResp
NameDescriptionTypeAdditional information
PersonId

Unique identification of the person in the system

 string

None.
Name

The name of the person

 string

None.
Surname

The surname of the person

 string

None.
OrganizationStructure

The involvement of the person in the organization structure

 string

None.
Department

Department. For Aktion CLOUD only

 string

None.
EmployeePosition

Employee position

 string

None.
Email

Email address of the person

 string

None.
MobilPhoneNumber

Mobile phone number of the person

 string

None.
PhoneNumber

Phone number of the person

 string

None.
LoginName

Login name of the person. For Aktion.NEXT only

 string

None.
DegreeInFrontName

Academic degree in front of the name

 string

None.
DegreeAfterName

Academic degree after the name

 string

None.
Sex

Sex of the person. {The meaning is: 0 - undefined; 1 - male; 2 - female }

 integer

None.
IdentifierEntryCode

Entry code of the person

 string

None.
IdentifierCard1

First card identifier of the person (Default identifier for person)

 string

None.
IdentifierCard2

Another card identifier of the person. Aktion.NEXT only

 string

None.
Desc

The description of the person

 string

None.
Lock

The access lock flag of the person identifiers {The meaning is: 0 - at least one identifier of the person is not locked; 1 - all identifiers of the person are locked }

 integer

None.
Identifiers

A list of all person identifiers

 Collection of Identifier

None.
TimeLastChange

The last change time of the data record. Can be used to check manual modification of data record

 date

None.
UdsCollection

The collection of available user defined columns of the agenda in the system:


SystemName: a2s15 IsExtern (Readonly) , Name: Aktuální předpis platnost od
SystemName: a2s7 IsExtern (Readonly) , Name: Minimální kvalita otisku
SystemName: a2s19 IsExtern (Readonly) , Name: Covid Negativní do
SystemName: a2s21 IsExtern (Readonly) , Name: Netestován do
SystemName: a2s20 IsExtern (Readonly) , Name: Covid Pozitivní do
SystemName: a2s13 IsExtern (Readonly) , Name: Kategorie strávníka
SystemName: a2s29 IsExtern (Readonly) , Name: Aktuální nákladové středisko
SystemName: a2s8 IsExtern (Readonly) , Name: Typ přístupu
SystemName: a2s17 [datetime], Name: Covid N
SystemName: a2s23 IsExtern (Readonly) , Name: Netestováno od
SystemName: a2s28 IsExtern (Readonly) , Name: Věk
SystemName: a2s9 IsExtern (Readonly) , Name: Skupina oprávnění
SystemName: a2s25 IsExtern (Readonly) , Name: ČasCTestu
SystemName: a2s18 [datetime], Name: Covid P
SystemName: a2s31 IsExtern (Readonly) , Name: Aktuální předpis název
SystemName: a2s16 IsExtern (Readonly) , Name: Aktuální předpis platnost do
SystemName: a2s3 [nvarchar(100)], Name: Maximální presčas
SystemName: a2s32 [bit], Name: Nepočítat stravenky
SystemName: a2s30 IsExtern (Readonly) , Name: Aktuální pracovní jednotka/y
SystemName: a2s24 IsExtern (Readonly) , Name: Způsob testování
SystemName: a2s6 IsExtern (Readonly) , Name: Oddělení

 Collection of UdsOut

None.

Response Formats

application/json

Sample: 
{"PersonId":"100200300","Name":"John","Surname":"Doo","OrganizationStructure":"Structure - Company - Office 1","Department":"Department 1","EmployeePosition":"Salesman","Email":"John.Doo@speedy.com","MobilPhoneNumber":null,"PhoneNumber":null,"LoginName":"John.Doo","DegreeInFrontName":"Mgr","DegreeAfterName":"PhD","Sex":0,"IdentifierEntryCode":"693723","IdentifierCard1":"A1B2C3D4E5","IdentifierCard2":"B1C2D3E4F5","Desc":null,"Lock":0,"Identifiers":[{"InternalNrLong":"A1B2C3D4E5","Type":0,"Status":0,"Holder":null,"HolderDefault":0,"TimeLastChange":"\/Date(-62135596800000)\/","RegistrationNr":null,"Technology":0,"Lock":0,"Security":0,"ValidFrom":null,"ValidTo":null,"UdsCollection":null},{"InternalNrLong":"B1C2D3E4F5","Type":0,"Status":0,"Holder":null,"HolderDefault":0,"TimeLastChange":"\/Date(-62135596800000)\/","RegistrationNr":null,"Technology":0,"Lock":0,"Security":0,"ValidFrom":null,"ValidTo":null,"UdsCollection":null}],"TimeLastChange":"\/Date(1761748057718)\/","UdsCollection":[{"SystemName":"a2s1","Name":"TestUDS_1","Value":"text in column","IsExtern":0,"DataType":"nvarchar(100)"},{"SystemName":"a2s2","Name":"TestUDS_2","Value":"2022-01-26T05:55:22","IsExtern":0,"DataType":"datetime"},{"SystemName":"a2s3","Name":"TestUDS_3","Value":"1","IsExtern":0,"DataType":"bit"}]}

application/xml

Sample: 

<Response>
  <PersonId>100200300</PersonId>
  <Name>John</Name>
  <Surname>Doo</Surname>
  <OrganizationStructure>Structure - Company - Office 1</OrganizationStructure>
  <Email>John.Doo@speedy.com</Email>
  <LoginName>John.Doo</LoginName>
  <Lock>0</Lock>
  <Identifiers>
    <Identifier>
      <InternalNrLong>A1B2C3D4E5</InternalNrLong>
      <Type>0</Type>
      <Status>0</Status>
      <HolderDefault>0</HolderDefault>
      <TimeLastChange>0001-01-01T00:00:00</TimeLastChange>
      <Technology>0</Technology>
      <Lock>0</Lock>
      <Security>0</Security>
    </Identifier>
    <Identifier>
      <InternalNrLong>B1C2D3E4F5</InternalNrLong>
      <Type>0</Type>
      <Status>0</Status>
      <HolderDefault>0</HolderDefault>
      <TimeLastChange>0001-01-01T00:00:00</TimeLastChange>
      <Technology>0</Technology>
      <Lock>0</Lock>
      <Security>0</Security>
    </Identifier>
  </Identifiers>
  <TimeLastChange>2025-10-29T14:27:37.7189867Z</TimeLastChange>
  <UdsCollection>
    <UdsOut>
      <SystemName>a2s1</SystemName>
      <Name>TestUDS_1</Name>
      <Value>text in column</Value>
      <IsExtern>0</IsExtern>
      <DataType>nvarchar(100)</DataType>
    </UdsOut>
    <UdsOut>
      <SystemName>a2s2</SystemName>
      <Name>TestUDS_2</Name>
      <Value>2022-01-26T05:55:22</Value>
      <IsExtern>0</IsExtern>
      <DataType>datetime</DataType>
    </UdsOut>
    <UdsOut>
      <SystemName>a2s3</SystemName>
      <Name>TestUDS_3</Name>
      <Value>1</Value>
      <IsExtern>0</IsExtern>
      <DataType>bit</DataType>
    </UdsOut>
  </UdsCollection>
</Response>