Skip to main content

Account Registry1.0.0

Building Safety Account Registry API for registering live locations.

Overview

The RapidSOS Account registry is a multifunctional tool used for both accounting and emergency call direction for our School Safety Solution. Your organization is fully responsible for maintaining records - inclusive of inserts, updates, and deletions.

All payload formats must match the specifications below, failure to do so may result in improper accounting. 

At any time an update occurs for a URI, all variables need to be sent again

Best Practice is to update end users within the RapidSOS Account Registry when they begin or terminate service automatically.

 

School Safety Registration & Accounting

{"uri": "client-id://1234" OR "client-phone://1234567890", (if phone, 10 digit number)
    "data": {
        "Client_Name": "School Name",      ---- string
        "Client_Type": "School",      ---- string
        "Client_Phone": "1234567890",      ---- string, 10 digit number E164 format    
        "Client_ID": "1234",      ---- string
        "Client_City": "New York",       ---- string
        "Client_State": "NY",      ---- string, 2 letter state abbreviation
        "Client_Zip_Code": "10016",      ---- string, 5 digit code
        "FCC_ID": "NY_1233",      ---- string
        "Responding_PSAP": "NYPD",       ---- string
        "Preferred_PSAP_Number": "+15558689966"      ---- string, 10 digit number E164 format
}

NOTE:

  • Your organization is responsible for updating the end users and removing them if service is cancelled

IMPORTANT SCHOOL SAFETY NOTES:

  • URI:
    • URI can be either a client id OR a telephone number
    • This must match exactly what you are sending within your payload
    • The character limit for a URI is 100
  • BOLDED FIELDS- optional routing structure

    • RapidSOS understands that some jurisdictions may work closely with their local schools and provide them a specific phone number to dial in the event of an emergency. While this is on a jurisdiction by jurisdiction basis, RapidSOS has made the ability for our clients to provide a specific ECC phone number for our Safety Agents to call:

      • If your organization plans to provide a specific ECC phone number, all three fields are required to ensure delivery of both a phone call and your digital alert to the appropriate ECC:

        • FCC ID:
          • The FCC ID is an ECC’s unique identifier provided by the Federal Communications Center. A link to the master Registry can be found below.
            • 911 Master Registry for ECC IDs
              • Please note that RapidSOS does not manage this list, but requires the FCC ID be provided at the time of onboarding should you use to utilize the specific phone number.
        • RESPONDING PSAP NAME
        • PREFERRED PSAP NUMBER
          • If your school has a specified ECC number, please enter it here. This number will be known by the school if it is needed.
          • Telephone number must be in E164 format, to include the +1

If you choose to utilize this optional routing structure, all three fields are required (FCC ID, Responding PSAP Name, and Responding PSAP Number) to ensure that a RapidSOS Safety Agent calls and sends a digital alert to the same ECC.

If a specific ECC is not provided, a pre-vetted third party database will be consulted, the closest geographic ECC to the alarm location will be connected.

    About us

    We build APIs that share data with first responders to help protect lives.