{"uid":"cap_imXF_2kNk2h2D-lfBcdKN","slug":"agents-openwebninja-com-waze-alerts-and-jams-eeaacea8","name":"Waze Alerts and Jams","description":"Get real-time alerts data and jams information from Waze in a geographic rectangular area by bottom-left and top-right latitude, longitude pairs. Supports all Waze alert types including: accidents, road blocks, hazards, traffic jams, police, and more.","url":"https://agents.openwebninja.com/waze/alerts-and-jams?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["bottom_left","top_right"],"properties":{"center":{"type":"string","description":"The center point of the area for which to return alerts and jams - specified as latitude, longitude pair. Required if bottom_left and top_right are not specified."},"radius":{"type":"string","description":"The radius of the area for which to return alerts and jams. Required if bottom_left and top_right are not specified. Required if bottom_left and top_right are not specified."},"max_jams":{"type":"integer","default":20,"description":"Maximum number of traffic jams to fetch (to avoid fetching traffic jams, set it to 0)."},"top_right":{"type":"string","description":"Top-right corner of the geographic rectangular area for which to get alerts and traffic jams.  \n  Specified as latitude, longitude pair. Required if center and radius are not specified. Required if center and radius are not specified."},"max_alerts":{"type":"integer","default":20,"description":"Maximum number of alerts to fetch (to avoid fetching alerts set it to 0)."},"alert_types":{"type":"string","description":"Only return alerts of specific types. Multiple alert types can be specified as a comma (,) separated list."},"bottom_left":{"type":"string","description":"Bottom-left corner of the geographic rectangular area for which to get alerts and traffic jams.  \n  Specified as latitude, longitude pair. Required if center and radius are not specified."},"radius_units":{"enum":["KM","MI"],"type":"string","default":"KM","description":"The unit of measurement for the radius parameter."},"alert_subtypes":{"type":"string","description":"Only return alerts of specific subtypes types. Multiple alert subtypes can be specified as a comma (,) separated list."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"jams":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City of the jam location."},"type":{"type":"string","description":"Jam type. Values: NONE, MODERATE, HEAVY, STAND_STILL."},"level":{"type":"integer","description":"Waze internal jam level (0–5)."},"jam_id":{"type":"string","description":"Unique identifier of the traffic jam."},"street":{"type":"string","nullable":true,"description":"Street name of the jam location."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the jam location."},"severity":{"type":"integer","description":"Severity score of the jam."},"speed_kmh":{"type":"number","description":"Average traffic speed in the jam, km/h."},"end_location":{"type":"string","nullable":true,"description":"Description of the jam's end location, when available."},"delay_seconds":{"type":"integer","nullable":true,"description":"Estimated delay caused by the jam in seconds. No longer provided by Waze (always null)."},"length_meters":{"type":"integer","description":"Length of the jam in meters."},"block_alert_id":{"type":"string","nullable":true,"description":"ID of the alert blocking the road, if the jam is caused by a road block."},"start_location":{"type":"string","nullable":true,"description":"Description of the jam's start location, when available."},"block_alert_type":{"type":"string","nullable":true,"description":"Type of the blocking alert."},"line_coordinates":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude in decimal degrees."},"lon":{"type":"number","description":"Longitude in decimal degrees."}}},"description":"Polyline of the jam as an ordered list of {lat, lon} points."},"update_datetime_utc":{"type":"string","description":"ISO 8601 UTC datetime the jam was last updated."},"driving_time_seconds":{"type":"integer","nullable":true,"description":"Time to drive through the jammed stretch in seconds (length / average speed), same as the Waze Live Map \"Driving time\". Null when traffic is stopped."},"publish_datetime_utc":{"type":"string","description":"ISO 8601 UTC datetime the jam was first published."},"block_alert_description":{"type":"string","nullable":true,"description":"Description of the blocking alert."},"block_start_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime the block began."},"block_alert_update_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime the blocking alert was last updated."}}},"description":"A list of traffic jams reported in the bounding box."},"alerts":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","nullable":true,"description":"City of the alert location."},"type":{"type":"string","description":"Alert category. Values include: ACCIDENT, HAZARD, JAM, ROAD_CLOSED, POLICE, CONSTRUCTION, MISC."},"image":{"type":"string","nullable":true,"description":"URL of an image attached to the alert, when available."},"street":{"type":"string","nullable":true,"description":"Street name of the alert location."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the alert location."},"near_by":{"type":"string","nullable":true,"description":"Nearby place or landmark, when reported."},"subtype":{"type":"string","nullable":true,"description":"More specific alert subtype, when provided."},"alert_id":{"type":"string","description":"Unique identifier of the alert."},"comments":{"type":"array","items":{"type":"object"},"description":"User comments left on the alert."},"latitude":{"type":"number","description":"Latitude of the alert in decimal degrees."},"longitude":{"type":"number","description":"Longitude of the alert in decimal degrees."},"description":{"type":"string","nullable":true,"description":"Human-readable description of the alert."},"report_mood":{"type":"integer","nullable":true,"description":"Waze reporter mood ID (the avatar mood of the reporting Wazer), passed through unchanged from the raw Waze alert data. Waze currently includes it only on alerts that are the cause of a returned traffic jam (see jams[].block_alert_id); null when Waze does not provide it."},"reported_by":{"type":"string","nullable":true,"description":"Reporter of the alert (e.g. a user handle or data source)."},"num_comments":{"type":"integer","description":"Number of user comments on the alert."},"num_thumbs_up":{"type":"integer","description":"Number of confirmations from other users."},"alert_confidence":{"type":"integer","description":"Waze confidence score for the alert."},"alert_reliability":{"type":"integer","description":"Waze reliability score for the alert."},"publish_datetime_utc":{"type":"string","description":"ISO 8601 UTC datetime the alert was published."}}},"description":"A list of alerts reported in the bounding box."}}},"status":{"type":"string","description":"The status of the request"},"parameters":{"type":"object","properties":{"max_jams":{"type":"integer","description":"The maximum number of traffic jams to return"},"top_right":{"type":"array","items":{"type":"string"},"description":"Coordinates of the top-right corner of the bounding box as [lat, lng] strings."},"max_alerts":{"type":"integer","description":"The maximum number of alerts to return"},"bottom_left":{"type":"array","items":{"type":"string"},"description":"Coordinates of the bottom-left corner of the bounding box as [lat, lng] strings."}}},"request_id":{"type":"string","description":"A unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_b_yFkYcMYjOdIP6IIMhpN","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns real-time Waze traffic alerts and jam data (accidents, road blocks, hazards, police, etc.) within a specified geographic bounding box or radius.","exampleAgentPrompt":"Pull live Waze alerts and traffic jams inside the bounding box from 37.7749,-122.5194 (bottom-left) to 37.8044,-122.4094 (top-right) in San Francisco — up to 30 alerts and 20 jams, and filter to accidents and hazards only.","exampleUseCases":[{"title":"Morning commute traffic check","prompt":"Check for any Waze traffic jams and accidents along the area between coordinates 40.7480,-74.0060 and 40.7580,-73.9760 in Manhattan right now — give me up to 25 alerts, focusing on accidents and road blocks."},{"title":"Event road closure monitoring","prompt":"I'm managing traffic around a stadium event in Los Angeles. Can you pull all Waze road block and police alerts within the bounding box from 34.0100,-118.2950 to 34.0400,-118.2550, showing up to 50 alerts?"},{"title":"Hazard detection for delivery routing","prompt":"Before I dispatch my delivery drivers, can you get current Waze hazard and jam data for the Chicago area between 41.8500,-87.7000 bottom-left and 41.9000,-87.6200 top-right, with a max of 30 jams and 30 alerts?"}],"resultDescription":"Returns a data object containing two arrays: 'alerts' with real-time incident reports (each including type, subtype, location coordinates, street, city, country, reliability score, and update timestamp) and 'jams' with traffic congestion records (each including jam type such as MODERATE/HEAVY/STAND_STILL, level 0–5, severity score, speed in km/h, length in meters, polyline coordinates, start/end location descriptions, and update timestamp).","failureModes":["Missing both bounding box and center/radius parameters returns a validation error","Invalid latitude/longitude format causes a bad request error","Very large geographic areas may return truncated results limited by max_alerts and max_jams","No alerts or jams in the requested area returns empty arrays","Rate limiting or payment/credit exhaustion returns 402 or 429 error","Waze data unavailability in certain regions may return sparse or empty results"],"whenToPreferThis":"Choose this endpoint when you need live Waze-sourced traffic intelligence — accidents, hazards, police sightings, road blocks, and congestion — for a specific geographic area defined by coordinates. It is superior to generic traffic APIs when Waze community-reported incident granularity and jam polylines are needed for routing decisions, fleet management, or real-time situational awareness. Prefer it over mapping APIs that only return historical or aggregated traffic data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:13.070Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-waze-alerts-and-jams-eeaacea8"}