{
"openapi": "3.0.1",
"info": {
"title": "EmergencyInfo API",
"description": "Emergency call handling. Integrate Public Safety Answering Point (PSAP) administrative call routing information plus Authority Having Jurisdiction (AHJ) phone numbers into your emergency services products and services.\nThe EmergencyInfo API retrieves U.S. 10-digit phone numbers and local contact info with the input of a location coordinate or an address . Useful for emergency services administrators, call handlers, and dispatchers.\n\n\n Error Codes
\n\nAPIs will return the following error codes in case of any error:\n\n\n| Error Code | Description\n|----------------------------|-------------------------------------------------------\n|DIS-1001 |Unauthorized, Invalid token\n|DIS-1002 |Not Authorized to access this API\n|DIS-1003 |Issue with internal services\n|DIS-1004 |Workspace Id is missing from Bearer Token\n|DIS-1005 |Rate limit exceeded\n|DIS-1006 |Unauthorized, Invalid key/secret\n|DIS-1007 |API quota has been permanently exhausted. No further requests are allowed for trial user\n|DIS-1008 |Invalid request ID, maximum allowed length is 38 characters\n|DIS-1009 |Access blocked due to too many failed attempts. Please try again after sometime\n|DIS-1010 |Workspace has been expired\n|DIS-EI-1001 |Request is not valid\n|DIS-EI-1002 |Required body is not specified\n|DIS-EI-1003 |Coordinates are not provided in the request\n|DIS-EI-1004 |Coordinates are invalid\n|DIS-EI-1005 |Latitude is invalid\n|DIS-EI-1006 |Longitude is invalid\n|DIS-EI-1007 |Required parameter is not specified\n|DIS-EI-1008 |fccId is invalid or missing\n|DIS-EI-1009 |This is not a valid fccId. Please try searching by address or by location methods\n \n",
"version": "1.0"
},
"servers": [
{
"url": "https://api.cloud.precisely.com"
}
],
"tags": [
{
"name": "PSAP",
"description": "Operations related to PSAP information"
},
{
"name": "PSAP-AHJ",
"description": "Operations related to PSAP-AHJ integration"
}
],
"paths": {
"/v1/emergency-info/psap-ahj/address": {
"post": {
"tags": [
"PSAP-AHJ"
],
"summary": "Accepts addresses and Returns contact details for Authorities Having Jurisdiction (AHJ)",
"description": "Accepts addresses as input and Returns contact details for Authorities Having Jurisdiction (AHJ) on-behalf-of local Public Safety Answering Points (PSAP).\nThe EmergencyInfo accepts an address and returns PSAP contact data plus contact data for an AHJ to communicate directly with a PSAP. Details include agency name, phone number, city name, contact person's details, site details and mailing addresses for EMS, Fire, and Police PSAP contacts.\n",
"operationId": "psapAhjAddress",
"parameters": [
{
"name": "X-Request-Id",
"in": "header",
"description": "The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.",
"schema": {
"type": "string"
},
"example": "123e4567-e89b-12d3-a456-426614174001"
}
],
"requestBody": {
"description": "Psap Ahj address information",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoAddressRequest"
},
"examples": {
"example": {
"value": {
"address": {
"addressLines": [
"860 White Plains Road Trumbull CT 06611, USA"
],
"admin1": "Connecticut",
"admin2": "Trumbull",
"city": "Trumbull",
"borough": "",
"suburb": "",
"postalCode": "06611",
"postalCodeExt": "",
"placeName": ""
}
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "PSAP-AHJ Retrieved Successfully ",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoPSAPAhjResponse"
},
"examples": {
"example": {
"value": {
"response": {
"status": "OK",
"ahjs": [
{
"ahjType": "ems",
"ahjId": "1300",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
{
"ahjType": "fire",
"ahjId": "1801",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
],
"psap": {
"psapId": "3242",
"fccId": "1404",
"type": "Enhanced",
"agency": "Trumbull Police Department",
"phone": "203-261-3665",
"county": {
"name": "Fairfield",
"fips": "09001"
},
"contactPerson": {
"title": "Dispatch Supervisor",
"fullName": "Sgt. George Floridia",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"phone": "203-261-3665",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"siteDetails": {
"phone": "203-261-3665",
"fax": "203-452-1060",
"contactName": "N/A",
"email": "police@trumbull-ct.gov",
"address": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
"mailingAddress": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid request for psap ahj address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "442e9b300c5afa7e925e2eda6997c3a3",
"errors": [
{
"code": "DIS-EI-1005",
"detail": "Longitude is invalid"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Invalid token for psap ahj address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "6f86a6d840194b497ee9aefb13beeb83",
"errors": [
{
"code": "DIS-1001",
"detail": "Unauthorized"
}
]
}
}
}
}
}
},
"403": {
"description": "Forbidden for psap ahj address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "214497c6134de13f86c9a338c75843b8",
"errors": [
{
"code": "DIS-1002",
"detail": "You do not have permission to access this API"
}
]
}
}
}
}
}
},
"429": {
"description": "Too many requests for psap ahj address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "db1c67f4df235f5b450e1b73798a011c",
"errors": [
{
"code": "DIS-1005",
"detail": "Rate limit exceeded"
}
]
}
}
}
}
}
},
"500": {
"description": "Internal server error for psap ahj address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "884de9142a30da6f498f7147afe3e372",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
},
"503": {
"description": "Psap ahj address service unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "b2a467d6ec0ee31f600df12bfe6e02ac",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
}
},
"security": [
{
"bearerAuth": []
},
{
"ApiKeyAuth": []
}
]
}
},
"/v1/emergency-info/psap-ahj/fccid": {
"get": {
"tags": [
"PSAP-AHJ"
],
"summary": "Accepts fccId as input and returns the relevant PSAP address and contact details.",
"description": "Accepts fccId as input and returns the relevant PSAP address and contact details including dispatch name, phone number, county name, contact person's details,\nsite details and mailing address, for local Public Safety Answering Points (PSAP).\n",
"operationId": "psapAhjFccID",
"parameters": [
{
"name": "X-Request-Id",
"in": "header",
"description": "The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.",
"schema": {
"type": "string"
},
"example": "123e4567-e89b-12d3-a456-426614174001"
},
{
"name": "fccId",
"in": "query",
"description": "Federal Communications Commission (FCC) identification number for PSAP record.",
"required": true,
"schema": {
"type": "string"
},
"example": "1048"
}
],
"responses": {
"200": {
"description": "PSAP-AHJ Retrieved Successfully using fccId ",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoPSAPAhjResponse"
},
"examples": {
"example": {
"value": {
"response": {
"status": "OK",
"ahjs": [
{
"ahjType": "ems",
"ahjId": "1300",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
{
"ahjType": "fire",
"ahjId": "1801",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
],
"psap": {
"psapId": "3242",
"fccId": "1404",
"type": "Enhanced",
"agency": "Trumbull Police Department",
"phone": "203-261-3665",
"county": {
"name": "Fairfield",
"fips": "09001"
},
"contactPerson": {
"title": "Dispatch Supervisor",
"fullName": "Sgt. George Floridia",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"phone": "203-261-3665",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"siteDetails": {
"phone": "203-261-3665",
"fax": "203-452-1060",
"contactName": "N/A",
"email": "police@trumbull-ct.gov",
"address": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
"mailingAddress": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid request for psap ahj fccID API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "442e9b300c5afa7e925e2eda6997c3a3",
"errors": [
{
"code": "DIS-EI-1005",
"detail": "Longitude is invalid"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Invalid token for psap ahj fccID API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "6f86a6d840194b497ee9aefb13beeb83",
"errors": [
{
"code": "DIS-1001",
"detail": "Unauthorized"
}
]
}
}
}
}
}
},
"403": {
"description": "Forbidden for psap ahj fccID API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "214497c6134de13f86c9a338c75843b8",
"errors": [
{
"code": "DIS-1002",
"detail": "You do not have permission to access this API"
}
]
}
}
}
}
}
},
"429": {
"description": "Too many requests for psap ahj fccID API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "db1c67f4df235f5b450e1b73798a011c",
"errors": [
{
"code": "DIS-1005",
"detail": "Rate limit exceeded"
}
]
}
}
}
}
}
},
"500": {
"description": "Internal server error for psap ahj fccID API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "884de9142a30da6f498f7147afe3e372",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
},
"503": {
"description": "Psap ahj fccID service unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "b2a467d6ec0ee31f600df12bfe6e02ac",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
}
},
"security": [
{
"bearerAuth": []
},
{
"ApiKeyAuth": []
}
]
}
},
"/v1/emergency-info/psap-ahj/location": {
"post": {
"tags": [
"PSAP-AHJ"
],
"summary": "Accepts latitude & longitude and Returns contact details for Authorities Having Jurisdiction (AHJ)",
"description": "Accepts latitude & longitude as input and Returns contact details for Authorities Having Jurisdiction (AHJ) on-behalf-of local Public Safety Answering Points (PSAP).\nEmergencyInfo API accepts a location coordinate and returns PSAP contact data plus contact data for an AHJ to communicate directly with a PSAP. Details include agency name, phone number, city name, contact person's details, site details and mailing addresses for EMS, Fire, and Police PSAP contacts.\n",
"operationId": "psapAhjLocation",
"parameters": [
{
"name": "X-Request-Id",
"in": "header",
"description": "The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.",
"schema": {
"type": "string"
},
"example": "123e4567-e89b-12d3-a456-426614174001"
}
],
"requestBody": {
"description": "Psap Ahj Location information",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoLocationRequest"
},
"examples": {
"example": {
"value": {
"location": {
"coordinates": [
-73.22344,
41.23443
]
}
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "PSAP-AHJ Retrieved Successfully using latitude & longitude",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoPSAPAhjResponse"
},
"examples": {
"example": {
"value": {
"response": {
"status": "OK",
"ahjs": [
{
"ahjType": "ems",
"ahjId": "1300",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
{
"ahjType": "fire",
"ahjId": "1801",
"type": "Private",
"fccId": "0",
"agency": "Trumball Fire and EMS (S.W. Regional Dispatch)",
"phone": "203-225-1135",
"comments": "Dial x0x for dispatch",
"contactPerson": {
"fullName": "Dispatch",
"phone": "203-261-3665",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"mailingAddress": {
"formattedAddress": "860 White Plains Road Trumbull CT 06611",
"formattedStreetAddress": "860 White Plains Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
],
"psap": {
"psapId": "3242",
"fccId": "1404",
"type": "Enhanced",
"agency": "Trumbull Police Department",
"phone": "203-261-3665",
"county": {
"name": "Fairfield",
"fips": "09001"
},
"contactPerson": {
"title": "Dispatch Supervisor",
"fullName": "Sgt. George Floridia",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"phone": "203-261-3665",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"siteDetails": {
"phone": "203-261-3665",
"fax": "203-452-1060",
"contactName": "N/A",
"email": "police@trumbull-ct.gov",
"address": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
"mailingAddress": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid request for psap ahj location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "442e9b300c5afa7e925e2eda6997c3a3",
"errors": [
{
"code": "DIS-EI-1005",
"detail": "Longitude is invalid"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Invalid token for psap ahj location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "6f86a6d840194b497ee9aefb13beeb83",
"errors": [
{
"code": "DIS-1001",
"detail": "Unauthorized"
}
]
}
}
}
}
}
},
"403": {
"description": "Forbidden for psap ahj location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "214497c6134de13f86c9a338c75843b8",
"errors": [
{
"code": "DIS-1002",
"detail": "You do not have permission to access this API"
}
]
}
}
}
}
}
},
"429": {
"description": "Too many requests for psap ahj location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "db1c67f4df235f5b450e1b73798a011c",
"errors": [
{
"code": "DIS-1005",
"detail": "Rate limit exceeded"
}
]
}
}
}
}
}
},
"500": {
"description": "Internal server error for psap ahj location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "884de9142a30da6f498f7147afe3e372",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
},
"503": {
"description": "Psap ahj location service unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "b2a467d6ec0ee31f600df12bfe6e02ac",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
}
},
"security": [
{
"bearerAuth": []
},
{
"ApiKeyAuth": []
}
]
}
},
"/v1/emergency-info/psap/address": {
"post": {
"tags": [
"PSAP"
],
"summary": "Accepts addresses and Returns contact details.",
"description": "Accepts addresses as input and Returns contact details for local Public Safety Answering Points (PSAP).\nThe EmergencyInfo accepts an address as input and returns the relevant PSAP address and contact details including agency name, phone number, county name, contact person's details, site details and mailing address.\n",
"operationId": "psapAddress",
"parameters": [
{
"name": "X-Request-Id",
"in": "header",
"description": "The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.",
"schema": {
"type": "string"
},
"example": "123e4567-e89b-12d3-a456-426614174001"
}
],
"requestBody": {
"description": "Psap address information",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoAddressRequest"
},
"examples": {
"example": {
"value": {
"address": {
"addressLines": [
"860 White Plains Road Trumbull CT 06611, USA"
],
"admin1": "Connecticut",
"admin2": "Trumbull",
"city": "Trumbull",
"borough": "",
"suburb": "",
"postalCode": "06611",
"postalCodeExt": "",
"placeName": ""
}
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "PSAP Retrieved Successfully ",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoPSAPResponse"
},
"examples": {
"example": {
"value": {
"response": {
"status": "OK",
"psap": {
"psapId": "3242",
"fccId": "1404",
"type": "Enhanced",
"agency": "Trumbull Police Department",
"phone": "203-261-3665",
"county": {
"name": "Fairfield",
"fips": "09001"
},
"contactPerson": {
"title": "Dispatch Supervisor",
"fullName": "Sgt. George Floridia",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"phone": "203-261-3665",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"siteDetails": {
"phone": "203-261-3665",
"fax": "203-452-1060",
"contactName": "N/A",
"email": "police@trumbull-ct.gov",
"address": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
"mailingAddress": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid request for psap address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "442e9b300c5afa7e925e2eda6997c3a3",
"errors": [
{
"code": "DIS-EI-1005",
"detail": "Longitude is invalid"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Invalid token for psap address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "6f86a6d840194b497ee9aefb13beeb83",
"errors": [
{
"code": "DIS-1001",
"detail": "Unauthorized"
}
]
}
}
}
}
}
},
"403": {
"description": "Forbidden for psap address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "214497c6134de13f86c9a338c75843b8",
"errors": [
{
"code": "DIS-1002",
"detail": "You do not have permission to access this API"
}
]
}
}
}
}
}
},
"429": {
"description": "Too many requests for psap address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "db1c67f4df235f5b450e1b73798a011c",
"errors": [
{
"code": "DIS-1005",
"detail": "Rate limit exceeded"
}
]
}
}
}
}
}
},
"500": {
"description": "Internal server error for psap address API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "884de9142a30da6f498f7147afe3e372",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
},
"503": {
"description": "Psap address service unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "b2a467d6ec0ee31f600df12bfe6e02ac",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
}
},
"security": [
{
"bearerAuth": []
},
{
"ApiKeyAuth": []
}
]
}
},
"/v1/emergency-info/psap/location": {
"post": {
"tags": [
"PSAP"
],
"summary": "Accepts latitude & longitude and Returns contact details.",
"description": " Accepts latitude & longitude as input and Returns contact details for local Public Safety Answering Points (PSAP).\n The EmergencyInfo accepts a location coordinate and returns the relevant PSAP address and contact details including dispatch name, phone number, county name, contact person's details, site details and mailing address.\n",
"operationId": "psapLocation",
"parameters": [
{
"name": "X-Request-Id",
"in": "header",
"description": "The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.",
"schema": {
"type": "string"
},
"example": "123e4567-e89b-12d3-a456-426614174001"
}
],
"requestBody": {
"description": "Psap Location information",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoLocationRequest"
},
"examples": {
"example": {
"value": {
"location": {
"coordinates": [
-73.22344,
41.23443
]
}
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "PSAP Retrieved Successfully ",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmergencyInfoPSAPResponse"
},
"examples": {
"example": {
"value": {
"response": {
"status": "OK",
"psap": {
"psapId": "3242",
"fccId": "1404",
"type": "Enhanced",
"agency": "Trumbull Police Department",
"phone": "203-261-3665",
"county": {
"name": "Fairfield",
"fips": "09001"
},
"contactPerson": {
"title": "Dispatch Supervisor",
"fullName": "Sgt. George Floridia",
"prefix": "Sgt.",
"firstName": "George",
"lastName": "Floridia",
"phone": "203-261-3665",
"fax": "203-452-1060",
"email": "gfloridia@trumbull-ct.gov",
"comments": "Dial x0x for dispatch",
"additionalDetails": "Dial -0- for DISPATCH."
},
"siteDetails": {
"phone": "203-261-3665",
"fax": "203-452-1060",
"contactName": "N/A",
"email": "police@trumbull-ct.gov",
"address": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
},
"mailingAddress": {
"formattedAddress": "158 Edison Road Trumbull CT 06611",
"formattedStreetAddress": "158 Edison Road",
"admin1": "CT",
"city": "Trumbull",
"country": "USA",
"postalCode": "06611"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid request for psap location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "442e9b300c5afa7e925e2eda6997c3a3",
"errors": [
{
"code": "DIS-EI-1005",
"detail": "Longitude is invalid"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Invalid token for psap location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "6f86a6d840194b497ee9aefb13beeb83",
"errors": [
{
"code": "DIS-1001",
"detail": "Unauthorized"
}
]
}
}
}
}
}
},
"403": {
"description": "Forbidden for psap location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "214497c6134de13f86c9a338c75843b8",
"errors": [
{
"code": "DIS-1002",
"detail": "You do not have permission to access this API"
}
]
}
}
}
}
}
},
"429": {
"description": "Too many requests for psap location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "db1c67f4df235f5b450e1b73798a011c",
"errors": [
{
"code": "DIS-1005",
"detail": "Rate limit exceeded"
}
]
}
}
}
}
}
},
"500": {
"description": "Internal server error for psap location API",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "884de9142a30da6f498f7147afe3e372",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
},
"503": {
"description": "Psap location service unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"example": {
"value": {
"id": "b2a467d6ec0ee31f600df12bfe6e02ac",
"errors": [
{
"code": "DIS-1003",
"detail": "Issue with internal services. Please try again after sometime"
}
]
}
}
}
}
}
}
},
"security": [
{
"bearerAuth": []
},
{
"ApiKeyAuth": []
}
]
}
}
},
"components": {
"schemas": {
"AHJ": {
"type": "object",
"properties": {
"ahjType": {
"type": "string",
"description": "Values: EMS, Police, Fire",
"example": "EMS"
},
"ahjId": {
"type": "string",
"description": "Persistent unique identification number for the record",
"example": "1300"
},
"type": {
"type": "string",
"description": "Types, such as City, County, Military, State, University, Regional",
"example": "Private"
},
"fccId": {
"type": "string",
"description": "Federal Communications Commission (FCC) identification number for EMS record",
"example": "0"
},
"agency": {
"type": "string",
"description": "Emergency service agency name",
"example": "Trumball Fire and EMS (S.W. Regional Dispatch)"
},
"phone": {
"type": "string",
"description": "Emergency number that is answered 24x7",
"example": "203-225-1135"
},
"comments": {
"type": "string",
"description": "General comments",
"example": "Emergency services"
},
"contactPerson": {
"description": "Contact Person",
"allOf": [
{
"$ref": "#/components/schemas/ContactPerson"
}
]
},
"mailingAddress": {
"description": "The AHJ Mailing Address",
"allOf": [
{
"$ref": "#/components/schemas/MatchedAddress"
}
]
}
},
"description": "Represents AHJ."
},
"AHJPlusPSAPResponse": {
"required": [
"status"
],
"type": "object",
"properties": {
"status": {
"$ref": "#/components/schemas/Status"
},
"ahjs": {
"type": "array",
"description": "List of AHJ (Authority Having Jurisdiction) records.",
"items": {
"$ref": "#/components/schemas/AHJ"
}
},
"psap": {
"description": "Details of the PSAP .",
"allOf": [
{
"$ref": "#/components/schemas/PSAP"
}
]
}
},
"description": "Represents ahj plus psap response."
},
"Address": {
"type": "object",
"properties": {
"addressLines": {
"type": "array",
"description": "Requested address, based on the country's addressing standard.",
"example": [
"1807 Market Blvd",
"Suite 200"
],
"items": {
"type": "string"
}
},
"admin1": {
"type": "string",
"description": "The largest geographic area, typically a state or province.",
"example": "Minnesota"
},
"admin2": {
"type": "string",
"description": "The secondary geographic area, typically a county or district.",
"example": "Dakota County"
},
"city": {
"type": "string",
"description": "Specifies a city or town name.",
"example": "hastings"
},
"borough": {
"type": "string",
"description": "Unit of local government or other administrative subdivision.",
"example": "Downtown"
},
"suburb": {
"type": "string",
"description": "Mixed-use or residential area within commuting distance of a city or urban area.",
"example": "North field Suburb"
},
"postalCode": {
"type": "string",
"description": "Main postal code.",
"example": "55033"
},
"postalCodeExt": {
"type": "string",
"description": "Secondary postal code, if one exists. For example, in the US, a ZIP+4 is 80125-8012.",
"example": "3492"
},
"placeName": {
"type": "string",
"description": "If applicable, indicates the name of the candidate's place or building.",
"example": "Empire State Building"
}
},
"description": "Represents a postal address, based on the country's addressing standard."
},
"ContactPerson": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Title of the contact person",
"example": "Dispatch Supervisor"
},
"fullName": {
"type": "string",
"description": "Full name of the contact person",
"example": "Sgt. George Floridia"
},
"prefix": {
"type": "string",
"description": "Prefix of the contact person",
"example": "Sgt."
},
"firstName": {
"type": "string",
"description": "First name of the contact person",
"example": "George"
},
"lastName": {
"type": "string",
"description": "Last name of the contact person",
"example": "Floridia"
},
"phone": {
"type": "string",
"description": "Phone number of the contact person",
"example": "203-261-3665"
},
"fax": {
"type": "string",
"description": "Fax number of the contact person",
"example": "203-452-1060"
},
"email": {
"type": "string",
"description": "Email address of the contact person",
"example": "gfloridia@trumbull-ct.gov"
},
"comments": {
"type": "string",
"description": "Additional comments about the contact person",
"example": "Dial -0- for DISPATCH."
},
"additionalDetails": {
"type": "string",
"description": "Additional details about the contact person",
"example": "Dial -0- for DISPATCH."
}
},
"description": "Contact person"
},
"County": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the county",
"example": "Fairfield"
},
"fips": {
"type": "string",
"description": "FIPS code for the county",
"example": "09001"
}
},
"description": "Name of the county where the PSAP is located"
},
"EmergencyInfoAddressRequest": {
"type": "object",
"properties": {
"address": {
"description": "Address request",
"allOf": [
{
"$ref": "#/components/schemas/Address"
}
]
}
},
"description": "Represents emergency info address request."
},
"EmergencyInfoLocationRequest": {
"type": "object",
"properties": {
"location": {
"description": "Location emergency info",
"allOf": [
{
"$ref": "#/components/schemas/LocationEmergencyInfo"
}
]
}
},
"description": "Represents emergency info location request."
},
"EmergencyInfoPSAPAhjResponse": {
"type": "object",
"properties": {
"response": {
"description": "AHJ plus PSAP response",
"allOf": [
{
"$ref": "#/components/schemas/AHJPlusPSAPResponse"
}
]
}
},
"description": "Represents emergency info PSAPAhj response."
},
"EmergencyInfoPSAPResponse": {
"type": "object",
"properties": {
"response": {
"description": "PSAP response",
"allOf": [
{
"$ref": "#/components/schemas/PSAPResponse"
}
]
}
},
"description": "Represents emergency info psap response."
},
"ErrorDetail": {
"required": [
"detail"
],
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "A unique code representing the specific error.",
"example": "DIS-1001"
},
"detail": {
"type": "string",
"description": "A detailed message describing the error.",
"example": "Unauthorized"
}
},
"description": "Error details."
},
"ErrorResponse": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the error.",
"example": "ad45c1aded938181a05f256e5a1b594d"
},
"errors": {
"type": "array",
"description": "List of errors ",
"items": {
"$ref": "#/components/schemas/ErrorDetail"
}
}
},
"description": "Error response."
},
"LocationEmergencyInfo": {
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"description": "Location Coordinates i.e. Longitude(-180 to 180) and Latitude(-90 to 90) of the Location. (WGS 84 datum/EPSG:4326 coordinate system)",
"example": [
-73.935242,
40.73061
],
"items": {
"type": "number",
"format": "double"
}
}
},
"description": "Represents location emergency info."
},
"MatchedAddress": {
"type": "object",
"properties": {
"formattedAddress": {
"type": "string",
"description": "All components of the address, formatted to the country's standard, on one line.",
"example": "158 Edison Road, Trumbull, CT 06611, USA"
},
"formattedStreetAddress": {
"type": "string",
"description": "Street portion of the address, including the directional and street suffix, formatted to the country's standard.",
"example": "158 Edison Road"
},
"formattedLocationAddress": {
"type": "string",
"description": "The complete matched last address line (city, state, and postal code).",
"example": "Trumbull, CT 06611"
},
"admin1": {
"type": "string",
"description": "The largest geographic area, typically a state or province.",
"example": "CT"
},
"admin2": {
"type": "string",
"description": "The secondary geographic area, typically a county or district.",
"example": "Fairfield"
},
"city": {
"type": "string",
"description": "Specifies a city or town name.",
"example": "Trumbull"
},
"street": {
"type": "string",
"description": "Street name only (no directional or street suffix).",
"example": "Edison Road"
},
"country": {
"type": "string",
"description": "Values are based on the ISO 3166-1 standard for country codes (returned in alpha-2, alpha-3, or numeric format)",
"example": "USA"
},
"postalCode": {
"type": "string",
"description": "Main postal code.",
"example": "06611"
},
"postalCodeExt": {
"type": "string",
"description": "Secondary postal code, if one exists. For example, in the US, a ZIP+4 is 80125-8012.",
"example": "80125-8012"
},
"unit": {
"type": "string",
"description": "The unit number, such as \"3B\".",
"example": "3B"
},
"unitType": {
"type": "string",
"description": "A group or suite of rooms within a building that are under common ownership or tenancy, typically having a common entrance. (APT, STE, FLAT, etc.).",
"example": "STE 100"
}
},
"description": "Matched address response"
},
"PSAP": {
"type": "object",
"properties": {
"psapId": {
"type": "string",
"description": "The PSAP Id, Persistent unique identification number for PSAP record",
"example": "3242"
},
"fccId": {
"type": "string",
"description": "Federal Communications Commission (FCC) identification number for EMS record",
"example": "1404"
},
"type": {
"type": "string",
"description": "Values: enhanced, basic, military, non-9-1-1",
"example": "Enhanced"
},
"agency": {
"type": "string",
"description": "The PSAP name",
"example": "Trumbull Police Department"
},
"phone": {
"type": "string",
"description": "Emergency number that is answered 24x7",
"example": "203-261-3665"
},
"county": {
"description": "Name of the county where the PSAP is located",
"allOf": [
{
"$ref": "#/components/schemas/County"
}
]
},
"contactPerson": {
"description": "Contact Person Details",
"allOf": [
{
"$ref": "#/components/schemas/ContactPerson"
}
]
},
"siteDetails": {
"description": "The PSAP site details",
"allOf": [
{
"$ref": "#/components/schemas/SiteDetails"
}
]
},
"mailingAddress": {
"description": "The PSAP Mailing Address",
"allOf": [
{
"$ref": "#/components/schemas/MatchedAddress"
}
]
}
},
"description": "Represents psap."
},
"PSAPResponse": {
"required": [
"status"
],
"type": "object",
"properties": {
"status": {
"$ref": "#/components/schemas/Status"
},
"psap": {
"description": "Details of the PSAP.",
"allOf": [
{
"$ref": "#/components/schemas/PSAP"
}
]
}
},
"description": "Represents psap response."
},
"SiteDetails": {
"type": "object",
"properties": {
"phone": {
"type": "string",
"description": "Phone number of the site",
"example": "203-261-3665"
},
"fax": {
"type": "string",
"description": "Fax number of the site",
"example": "203-452-1060"
},
"contactName": {
"type": "string",
"description": "Contact name at the site",
"example": "N/A"
},
"email": {
"type": "string",
"description": "Email address for contacting the site",
"example": "police@trumbull-ct.gov"
},
"address": {
"description": "Mailing address of the site",
"allOf": [
{
"$ref": "#/components/schemas/MatchedAddress"
}
]
}
},
"description": "Represents the details of the site associated with a PSAP."
},
"Status": {
"type": "string",
"description": "Represents the status of a response",
"example": "OK",
"enum": [
"OK",
"ZERO_RESULTS"
]
}
},
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"description": "Pass the value in the following format: Apikey .",
"name": "Authorization",
"in": "header"
},
"bearerAuth": {
"type": "http",
"description": "Pass the value as JWT Bearer Token.",
"scheme": "bearer"
}
}
}
}