Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: US Army Public Articles News API
description: The US Army Public API provides public access to Army news articles, events, personnel information, and other publicly available Army information. The API is documented with Swagger UI at api.army.mil.
version: 2.0.0
contact:
name: US Army Web Support Team
url: https://api.army.mil/
license:
name: Public Domain
url: https://creativecommons.org/publicdomain/zero/1.0/
servers:
- url: https://api.army.mil/api/v1
description: US Army Public API production server
tags:
- name: News
paths:
/news:
get:
operationId: getNews
summary: Get News Items
description: Retrieve US Army news items including press releases and official announcements.
tags:
- News
parameters:
- name: limit
in: query
required: false
description: Maximum number of news items to return
schema:
type: integer
default: 20
- name: offset
in: query
required: false
description: Pagination offset
schema:
type: integer
default: 0
responses:
'200':
description: List of news items
content:
application/json:
schema:
$ref: '#/components/schemas/NewsList'
components:
schemas:
NewsList:
type: object
properties:
total:
type: integer
limit:
type: integer
offset:
type: integer
items:
type: array
items:
$ref: '#/components/schemas/NewsItem'
NewsItem:
type: object
description: A US Army press release or news item
properties:
id:
type: string
description: Unique news item identifier
headline:
type: string
description: News headline
summary:
type: string
description: Brief summary
publishedDate:
type: string
format: date-time
description: Publication date
url:
type: string
format: uri
description: Link to full news item
source:
type: string
description: Publishing organization
required:
- id
- headline
- publishedDate