Contents x
    Get device details
    • 28 Oct 2024
    • 6 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    • PDF
    Contents

    Get device details

    • Updated on 28 Oct 2024
    • 6 Minutes to read
    • Contributors
    • Print
    • Dark
      Light
    • PDF
    Article summary

    Get
    /devices/{id}/

    Operation is used to retrieve full details of given device id. Available from product version 3.0.24.

    Security
    API Key
    Header parameter nameAuthorization

    Token issued for API consumer.

    Path parameters
    id
    integerRequired

    Id of device

    Responses
    200

    Device

    Expand All
    object
    comments
    string

    Remarks

    connectorCount
    integer

    Connector count

    createdBy
    string

    creator

    createdTs
    string (date-time)

    Creation date and time

    id
    integer

    Primary key

    identification
    string

    Identification

    interface
    string

    Interface

    locationArea
    string

    Location area. Available from product version 3.6.

    locationRack
    string

    Location rack. Available from product version 3.6.

    locationRackRow
    string

    Location rack row. Available from product version 3.6.

    locationSide
    string

    Location side. Available from product version 3.6.

    locationSlot
    string

    Location slot. Available from product version 3.6.

    locationSubSlot
    string

    Location sub slot. Available from product version 3.6.

    locationSubrack
    string

    Location sub rack. Available from product version 3.6.

    managementAddress
    string

    Management address

    managementAddress2
    string

    Management address 2

    orderNo
    integer

    Order number

    owner
    object (TerminalOwner)

    Terminal owner

    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[ "DEVICE_OWNER" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    parent
    object (Device)
    comments
    string

    Remarks

    connectorCount
    integer

    Connector count

    createdBy
    string

    creator

    createdTs
    string (date-time)

    Creation date and time

    id
    integer

    Primary key

    identification
    string

    Identification

    interface
    string

    Interface

    locationArea
    string

    Location area. Available from product version 3.6.

    locationRack
    string

    Location rack. Available from product version 3.6.

    locationRackRow
    string

    Location rack row. Available from product version 3.6.

    locationSide
    string

    Location side. Available from product version 3.6.

    locationSlot
    string

    Location slot. Available from product version 3.6.

    locationSubSlot
    string

    Location sub slot. Available from product version 3.6.

    locationSubrack
    string

    Location sub rack. Available from product version 3.6.

    managementAddress
    string

    Management address

    managementAddress2
    string

    Management address 2

    orderNo
    integer

    Order number

    owner
    object (TerminalOwner)

    Terminal owner

    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[ "DEVICE_OWNER" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    parent
    object (Device) Recursive
    premise
    string (url)

    Url to fetch details of related telecom premises.

    renter
    object (TerminalRenter)

    Terminal renter

    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[ "DEVICE_OWNER" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    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 contants 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. Available from product version 3.4.

    startPin
    integer

    Start connector

    type
    object (TerminalType)

    Terminal type

    availabilityEnd
    string (date-time)

    Availability end date and time

    availabilityStart
    string (date-time)

    Availability start date and time

    clazz
    object (TerminalTypeClass)

    Terminal type class

    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[ "DEVICE, CTV_DEVICE" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    connectors
    integer

    Connectors

    fcode
    integer

    Feature code

    id
    integer

    Primary key

    listUrl
    string (url)

    Url to fetch all contants from terminal types

    technology
    object (TerminalTech)

    Terminal type technology

    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[ "TERMINAL_TECH" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    type
    string

    Type

    updatedBy
    string

    Last updater

    updatedTs
    string (date-time)

    Last update date time

    usageState
    object (TerminalState)

    Terminal 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[ "TERMINAL_STATE" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    premise
    string (url)

    Url to fetch details of related telecom premises.

    renter
    object (TerminalRenter)

    Terminal renter

    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[ "DEVICE_OWNER" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    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 contants 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. Available from product version 3.4.

    startPin
    integer

    Start connector

    type
    object (TerminalType)

    Terminal type

    availabilityEnd
    string (date-time)

    Availability end date and time

    availabilityStart
    string (date-time)

    Availability start date and time

    clazz
    object (TerminalTypeClass)

    Terminal type class

    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[ "DEVICE, CTV_DEVICE" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    connectors
    integer

    Connectors

    fcode
    integer

    Feature code

    id
    integer

    Primary key

    listUrl
    string (url)

    Url to fetch all contants from terminal types

    technology
    object (TerminalTech)

    Terminal type technology

    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[ "TERMINAL_TECH" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    type
    string

    Type

    updatedBy
    string

    Last updater

    updatedTs
    string (date-time)

    Last update date time

    usageState
    object (TerminalState)

    Terminal 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[ "TERMINAL_STATE" ]
    id
    integer

    Unique id of constant

    list_url
    string (url)

    Url to fetch all contants 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

    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

    Was this article helpful?
    What's Next
    Products
    Company
    Our Mission
    Connect With Us
    Support
    Copyright © Keypro Oy. All Rights Reserved