Additional Data
RAD-enhanced
Data Sources
IamResponding (IaR)
ECCs/PSAPs
Request for Knowledge Article
RAD-enhanced

Overview

The RAD (RapidSOS Additional Data) Enhanced API provides a RESTful interface for querying additional data from various sources. Data from these sources is queried by phone number or RapidSOS Alert ID. It can also be queried by unique identifiers associated with the owner of the data, such as their phone number or MedicAlert ID.

IMPORTANT: It is strongly recommended that when integrating this API, fields should not be hard-coded. This is because it assumes that information which should be flexible is actually fixed and unchanging. It is best practice to develop a UI renderer based on our auto-rendering schema language to allow for generating UI components native to your software for any data fields that might be added, updated, etc. for any source.

Data Access

All available sources of additional data provided to RapidSOS that your integration has been approved to receive will be made available using the RAD Enhanced endpoint.

Data Sources

The available data sources allow a pre-defined "display" schema for data received by RapidSOS Portal. This dynamic schema allows it to automatically infer how these elements should be rendered.

Example Data Sources

  • 911 Inform
  • 911Secure
  • Cove
  • Emergency Health Profile
  • MedicAlert
  • SiriusXM
  • Uber

Rendering Schema and Data

The schema is defined per data source and dictates field ordering, labeling, formatting, etc. allowing for the automatic processing and rendering of the many new data types without the need for new UI development work every time a new data set is added.

Auto Generate Components from Data and Schema : The library takes a data object and a display schema as its input and return UI components representing those data points as defined by the display schema.

Text, Link, and Timestamp Support

The library can support rendering data as either text, a URL link, a human readable timestamp, hidden, dates and images. The criteria for rendering based on the schema is as follows:

Sample web-url:
  • type: string
  • format: web-url
  • Recommended UI Element Type: clickable link (optional)
{
  “link_example”: {
    “type”: “string”,
    “format”: “web-url”
  }
}
Sample timestamp:
  • type: integer
  • format: timestamp
  • UI: ISO80 Datestring
{
  “timestamp_example”: {
    “type”: “integer”,
    “format”: “timestamp”
  }
}
Sample plain text:
  • type: integer, number, or string
  • format: None specified. This can optionally be text.
  • UI: text
{
  “plain_text_example”: {
    “type”: “string”
  }
}

Object Rendering

The library supports rendering fields with nested objects. The display schema defines these fields as an object and defines a display schema for each nested field within it. These nested fields cannot be objects or arrays. They must be strings or numbers.

Sample nested object data and display schema:

Data

{
  “object_field_example”: {
    “nested_simple_field”: 55
  }
}

Display Schema

{
  “object_field_example”: {
    “type”: “object”,
     “properties”: {
       “nested_simple_field”: {
          “type”: “integer”
       }
     }
  }
}

Array Rendering

The library can support rendering a field whose value is a list of values. These values can be any strings, numbers, or objects.

Generated UI components should provide a visual indicator separating each element of the list from one another.

Sample array data and display schema:

{
  “array_field_example”: [1, 2, 3]
}
Display Schema
{
  “array_field_example”: {
    “type”: “array”,
     “items”: {
        “type”: “integer”
     }
  }
}

Ordered Components

The display schema defines a propertiesOrder attribute that defines the expected order in which each property is meant to be rendered.

Your renderer should use this ordered list defined in the attribute to determine the order in which to render all properties within any object in the schema.

Example Schema

The following is an illustrative example of a fictitious ABC Corporation schema defining all required top-level attributes as well as at least one field of each of the types supported:

{
  "$schema": "http://json-schema.org/example-01/schema#",
  "type": "object",
  "title": "ABC Corporation Crash Detection",
  "propertiesOrder": ["id", "datetime", "location", "vehicle", "impacts", "airbags", "seats", "contacts"],
  "properties": {
    "id": {
      "type": "string",
      "title": "Crash ID"
    },
    "datetime": {
      "type": "integer",
      "format": "timestamp",
      "title": "Crash Time"
    },
    "location": {
      "type": "object",
      "title": "Crash Location",
      "propertiesOrder": ["latitude", "longitude", "timestamp", "speed", "bearing"],
      "properties": {
        "timestamp": {
          "type": "integer",
          "format": "timestamp",
          "title": "Location Time"
        },
        "latitude": {
          "type": "number",
          "title": "Latitude"
        },
        "longitude": {
          "type": "number",
          "title": "Longitude"
        },
        "bearing": {
          "type": "number",
          "title": "Bearing (In Degrees)"
        },
        "speed": {
          "type": "number",
          "title": "Speed (In M/S)"
        }
      }
    },
    "vehicle": {
      "type": "object",
      "title": "Vehicle Information",
      "propertiesOrder": ["make", "model", "color", "year", "vin"],
      "properties": {
        "vin": {
          "type": "string",
          "title": "Vin #"
        },
        "make": {
          "type": "string",
          "title": "Manufacturer"
        },
        "model": {
          "type": "string",
          "title": "Model"
        },
        "year": {
          "type": "string",
          "title": "Year"
        },
        "color": {
          "type": "string",
          "title": "Color"
        }
      }
    },
    "seats": {
      "type": "array",
      "title": "Seat Occupancy",
      "items": {
        "type": "object",
        "propertiesOrder": ["occupancy", "belt", "side", "row"],
        "properties": {
          "row": {
            "type": "integer",
            "title": "Seat Row"
          },
          "side": {
            "type": "string",
            "title": "Seat Side"
          },
          "occupancy": {
            "type": "string",
            "title": "Occupancy"
          },
          "belt": {
            "type": "string",
            "title": "Seatbelt Status"
          }
        }
      }
    },
    "airbags": {
      "type": "array",
      "title": "Airbag Statuses",
      "items": {
        "type": "object",
        "propertiesOrder": ["name", "deployed"],
        "properties": {
          "name": {
            "type": "string",
            "title": "Airbag Name"
          },
          "deployed": {
            "type": "string",
            "title": "Deployment Status"
          }
        }
      }
    },
    "impacts": {
      "type": "array",
      "title": "Vehicle Impacts",
      "items": {
        "type": "object",
        "propertiesOrder": ["front_crash", "driver_side_crash", "pass_side_crash", "rear_crash", "rollover", "sequence"],
        "properties": {
          "sequence": {
            "type": "integer",
            "title": "Impact Sequence"
          },
          "front_crash": {
            "type": "string",
            "title": "Front Crash Detected"
          },
          "driver_side_crash": {
            "type": "string",
            "title": "Driver Side Crash Detected"
          },
          "pass_side_crash": {
            "type": "string",
            "title": "Passenger Side Crash Detected"
          },
          "rear_crash": {
            "type": "string",
            "title": "Rear Crash Detected"
          },
          "rollover": {
            "type": "string",
            "title": "Rollover Detected"
          }
        }
      }
    },
    "contacts": {
      "type": "array",
      "title": "Emergency Contacts",
      "items": {
        "type": "object",
        "propertiesOrder": ["name", "phone_number", "note"],
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "phone_number": {
            "type": "string",
            "title": "Phone",
            "format": "phone-number"
          },
          "note": {
            "type": "string",
            "title": "Note"
          }
        }
      }
    }
  }
}

Additional Considerations

The following considerations should be reviewed before implementing the RapidSOS Additional Data (RAD-E) solution:

  • Uber data: we do not receive differentiation regarding if the driver or rider triggered the alarm
  • There is not always additional data available for a call
  • Regarding data retention and privacy, the data we provide is all voluntarily
  • The partner must have the caller ID to query the API
  • Additional Data is available for 10 minutes from the first push by the data partner
  • Partners should make use of key error handling and utilize loops through the API response