 API: News
All news stories, deployed or not, with their photos, attachments, and videos.
Calling the Endpoint
| HTTP Request Type | GET |
| Calling URI | https://www.YourDepartment.com/apps/api/news/ |
| Request Header | Authorization: Bearer {access_token} |
Parameters
| Parameter | Description |
ID |
Optional. A single story ID. |
CategoryID |
Optional. Limit to one category (the categoryId value). |
StartDate |
Optional. Only stories dated on or after this date (yyyy-mm-dd). |
EndDate |
Optional. Only stories dated on or before this date (yyyy-mm-dd). |
Response Properties
| Property | Description |
id |
Story ID (number) |
date |
Story date/time (string) |
headline |
Headline (string) |
deployed |
1 = deployed (live on the site), 0 = not deployed (number) |
author |
Story credit as typed on the story; free text, unlike createdBy (string) |
text |
Story body, may contain HTML (string) |
address |
Incident address (string) |
units |
Responding units (string) |
mutualAid |
Mutual aid (string) |
featured |
1 = featured story (number) |
categoryId |
Category ID (number) |
category |
Category name (string) |
created |
Posted date/time (string) |
createdBy |
Posting member's name (string) |
modified |
Last modified date/time; empty if never modified (string) |
modifiedBy |
Modifying member's name; empty if never modified (string) |
links |
Array of {text, url} related links |
images |
Array of {id, url, caption, width, height, fileSize, front}; front = 1 marks the story's front image |
attachments |
Array of {id, fileName, url, extension, fileSize, posted} |
videos |
Array of {id, embedCode, posted}; embedCode is the YouTube embed code |
Sample Request
GET https://www.YourDepartment.com/apps/api/news/?MaxRows=1
Authorization: Bearer {access_token}
Sample Response
{
"status": 200,
"endpoint": "news",
"domain": "www.YourDepartment.com",
"generated": "2026-09-06 09:15:00",
"startRow": 1,
"maxRows": 1,
"count": 1,
"totalCount": 1204,
"items": [
{
"id": 1204,
"date": "2026-09-04 00:00:00",
"headline": "Crews Respond to Two Alarm House Fire",
"deployed": 1,
"author": "Firefighter Dan Lee",
"text": "Just after 2 AM, companies were alerted for a reported house fire on Main Street. First arriving units found heavy fire showing from the rear of a two-story dwelling...",
"address": "412 Main Street",
"units": "Engine 71, Tower 7, Rescue 7",
"mutualAid": "Station 12",
"featured": 1,
"categoryId": 1,
"category": "Incident News",
"created": "2026-09-04 08:10:00",
"createdBy": "Dan Lee",
"modified": "",
"modifiedBy": "",
"links": [
{ "text": "County Fire Wire Coverage", "url": "https://example.com/story" }
],
"images": [
{
"id": 3311,
"url": "https://www.YourDepartment.com/files/news/1204/fire1.jpg",
"caption": "Crews open the roof",
"width": 1600,
"height": 1200,
"fileSize": 412876,
"front": 1
}
],
"attachments": [],
"videos": []
}
]
}
Records are returned in the items array. count is the
number of records in this response; totalCount is all matching records regardless of paging. Page with
StartRow and MaxRows (default 100, maximum 1000) until count + startRow exceeds totalCount.
Back to the API Documentation
|
September 21, 2026: