GET apioauth/v4/movementalert/{movementAlertId}

Get a movement alert by id

Request Information

URI Parameters

NameDescriptionTypeAdditional information
movementAlertId

The alert id being queried

integer

Required

Body Parameters

None.

Response Information

Resource Description

A GetMovementAlertResponse

OAuthGetMovementAlertResponse
NameDescriptionTypeAdditional information
Id

The id of the alert

integer

None.

Title

The alert title

string

None.

Message

The alert message

string

None.

AlertDistance

The alert distance in metres

integer

None.

SingleAlertPerJourney

If you want 1 alert per journey

boolean

None.

EmailRecipients

A list of email recipients

Collection of string

None.

ActiveStartTime

When you want the alert to be active from - The start time must be before the end time

time interval

None.

ActiveEndTime

When you want the alert to be active to - The start time must be before the end time

time interval

None.

ActiveDays

A bitmask of the days you want the alert to be active, eg Wed and Thurs would be 8 + 16 = 24

AlertDays

None.

ServiceIds

The service ids you want setting up on the alert

Collection of integer

None.

Response Formats

application/json, text/json

Sample:
{
  "Id": 1,
  "Title": "sample string 2",
  "Message": "sample string 3",
  "AlertDistance": 4,
  "SingleAlertPerJourney": true,
  "EmailRecipients": [
    "sample string 1",
    "sample string 2"
  ],
  "ActiveStartTime": "00:00:00.1234567",
  "ActiveEndTime": "00:00:00.1234567",
  "ActiveDays": 1,
  "ServiceIds": [
    1,
    2
  ]
}

application/xml, text/xml

Sample:
<OAuthGetMovementAlertResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>1</Id>
  <Title>sample string 2</Title>
  <Message>sample string 3</Message>
  <AlertDistance>4</AlertDistance>
  <SingleAlertPerJourney>true</SingleAlertPerJourney>
  <EmailRecipients>
    <string>sample string 1</string>
    <string>sample string 2</string>
  </EmailRecipients>
  <ActiveStartTime />
  <ActiveEndTime />
  <ActiveDays>Sunday</ActiveDays>
  <ServiceIds>
    <long>1</long>
    <long>2</long>
  </ServiceIds>
</OAuthGetMovementAlertResponse>