Get Contact Persons details.

Prev Next
Get
/contact-persons/{id}/

Operation is used to retrieve full details of given contact person id.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Path parameters
id
integerRequired

Id of contact person

Responses
200

Contact Person

{
  "Address": {
    "address": {
      "apartments": [
        "http://example.com/api/v2/apartments/2424968/"
      ],
      "buildingId": "",
      "building_name": null,
      "city": "MOST COMMON STREET",
      "cityAlt": "",
      "country": "",
      "createdBy": "test user",
      "createdTs": "2022-05-05T21:25:43.998Z",
      "district": "",
      "empty": 0,
      "id": 29647850,
      "listUrl": "http://example.com/api/v2/addresses/",
      "location": "SRID=3067;POINT (674524.00220502 6934108.1091534)",
      "municipality": "",
      "propertyId": "",
      "province": "",
      "sourceSystem": null,
      "sourceSystemKey": null,
      "streetname": "TESTS",
      "streetnameAlt": "",
      "streetno": "2",
      "subdivision": "",
      "updatedBy": "test user",
      "updatedTs": "2022-08-10T11:23:39.624Z",
      "usagePurpose": null,
      "usagePurposeAlt": null,
      "zipcode": ""
    },
    "apartmentDivision": null,
    "apartmentLetter": null,
    "apartmentNumber": null,
    "empty": 1,
    "id": 2424968,
    "listUrl": "/api/v2/apartments/",
    "originProperty": "//0000001949546",
    "originalStreetno": null,
    "sourceSystem": null,
    "sourceSystemKey": null,
    "usagePurpose": null,
    "usagePurposeAlt": null,
    "usageState": null
  },
  "Role": {
    "availability_end_ts": null,
    "availability_start_ts": null,
    "available": true,
    "groupname": "CONTACT_ROLE",
    "id": 27371,
    "list_url": "http://example.com/api/v2/txt_constants/groupname/CONTACT_ROLE/",
    "logical_txt": "Contact person",
    "num_value": 0.0,
    "num_value2": null,
    "num_value3": null,
    "num_value4": null,
    "txt": "Yhteyshenkilö"
  },
  "comments": "Test contact person via contact person rest api",
  "contact_person_restricted_type": null,
  "contact_start_date": "2025-02-07",
  "created_by": "test user",
  "created_ts": "2025-07-25T14:34:26.013Z",
  "customer_number": "ContactPerson123",
  "email": "jdoe@us.ibm.com",
  "fax": "490-521-0709",
  "id": 127120,
  "name": "John Doe",
  "phone": "1234567890",
  "phone2": "123-456-7890"
}
Expand All
object

A full representation of a Contact Person object, used for listing or retrieving contact person details.

comments
string

Additional comments about the contact person.

contact_start_date
string (date)

Start date of the contact person.

created_by
string

User who created the contact person.

created_ts
string (date-time)

Timestamp when the contact person was created.

customer_number
string

Customer number associated with the contact person.

email
string (email)

Email address of the contact person.

fax
string

Fax number of the contact person.

id
integer

Unique identifier for the contact person.

name
string

Name of the contact person.

phone
string

Primary phone number of the contact person.

phone2
string

Secondary phone number of the contact person.

Address
object (Apartment)
address
object (Address)
buildingId
string

Building id

buildingName
string

Building name

city
string

Building city name

cityAlt
string

Building city name in alternative language

country
string

Building country

createdBy
string

creator

createdTs
string (date-time)

Creation date and time

district
string

Building district

empty
integer

Address with this value as 1 is default address. Modifying or deleting such address is prohibited.

Valid values[ 0, 1 ]
id
integer

Primary key

location
string (ewkt)

Geographical location

municipality
string

Building municipality

propertyId
string

Property number

province
string

Building province

sourceSystem
object (SourceSystem)

External source system

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "SOURCE_SYSTEM" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

sourceSystemKey
integer

source system key

streetname
string

Building street name

streetnameAlt
string

Building street name in alternative language

streetno
string

Building number

subdivision
string

Building municipality subdivision

updatedBy
string

Last updater

updatedTs
string (date-time)

Last update date time

usagePurpose
object (BuildingUsage)

Building usage purpose

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "BUILDING_USAGE" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

usagePurposeAlt
object (AddressSecondaryUsage)

Address usage purpose

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "KN_ADDR_SPEC" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

zipcode
string

Building zipcode

apartmentDivision
string

apartment division

apartmentLetter
string

apartment letter

apartmentNumber
string

apartment number

empty
integer

Apartment with this value as 1 is default apartment. Modifying or deleting such apartment is prohibited.

Valid values[ 0, 1 ]
id
integer

Primary key

originProperty
string

apartment original property id

originalStreetno
string

apartment original streen number

sourceSystem
object (SourceSystem)

External source system

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "SOURCE_SYSTEM" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

sourceSystemKey
integer

source system key

usagePurpose
object (ApartmentUsage)

Apartment Usage purpose

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "APARTMENT_USAGE" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

usagePurposeAlt
object (AddressSecondaryUsage)

Address usage purpose

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "KN_ADDR_SPEC" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

usageState
object (ApartmentStatus)

Apartment status

availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname

Group name of constant

Valid values[ "APARTMENT_STATUS" ]
id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

Role
object (TxtConstant)
availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname
string

Group name of constant

id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

contact_person_restricted_type
object (TxtConstant)
availability_end_ts
string (date-time)

Ending date time for availability

availability_start_ts
string (date-time)

Beginning date time for availability

available
boolean

Is object deemed as available. Based on availability_start_ts and availability_end_ts values.

groupname
string

Group name of constant

id
integer

Unique id of constant

list_url
string (url)

Url to fetch all constants from this group

logical_txt
string

Logical textual value

num_value
number (float)

Numeric value

num_value2
number (float)

Numeric value 2

num_value3
number (float)

Numeric value 3

num_value4
number (float)

Numeric value 4

txt
string

Human readable textual representation

list_url
string (uri)

URL to the list of contact persons.

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object
details
string

Detailed description of error

404

Object was not found

{
  "details": "Not found."
}
object
details
string

Detailed description of error