---
title: "Get news articles"
method: GET
path: "/v4/user/news"
tags: ["News (v4)"]
---

# Get news articles

`GET /v4/user/news`

## Request

- Base URL: `https://trading-api.oanda.com` (the document declares no server; this is the origin it was published from)
- URL: `https://trading-api.oanda.com/v4/user/news`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/oanda/apis/up-gateway-v1/docs/v4/user/news/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves news articles based on the user's division.
Supports pagination and historical news access with date range filtering.
For OJ divisions (9, 10), news is fetched from OJ news source.
For OTMS, news is fetched from TMS news source.
For all other divisions, news is fetched from OANDA news source.

## Query parameters

- `divisionId` number, required: OC: 1, CANADA: 2, OAP: 3, OEL: 4, TEST: 5, ECP: 6, OAP_CFD: 7, OCI: 8, OJ_NON_CORPORATE: 9, OJ_CORPORATE: 10, OAU: 11, OEM: 12, OGM: 13, OT: 14 OPUC: 17
- `offset` integer
- `limit` integer
- `dateSortDirection` 'asc' | 'desc'
- `from` string
- `to` string
- `language` 'en' | 'ar' | 'de' | 'ru' | 'zh' | 'ja' | 'nl' | 'fa' | 'fr' | 'el' | 'it' | 'ko' | 'pt' | 'es' | 'tr' | 'pl': ISO 639-1 language code

## Response `200`

News articles retrieved successfully

- object
  - `data` object[], required
    - `id` integer, required
    - `title` string, required
    - `content` string, required
    - `contentType` 'html' | 'plaintext', required: The format of the news content
    - `timestamp` string, date-time, required
    - `country` string, nullable
    - `language_code` 'en' | 'ar' | 'de' | 'ru' | 'zh' | 'ja' | 'nl' | 'fa' | 'fr' | 'el' | 'it' | 'ko' | 'pt' | 'es' | 'tr' | 'pl': ISO 639-1 language code
    - `summary` string
    - `url_link` string, uri, nullable
    - `tags` string[]
    - `source` string, nullable

## Other responses

- `400`: Bad request - Invalid parameters

---

[API](https://skmtc.dev/oanda/apis/up-gateway-v1.md) - [All operations](https://skmtc.dev/oanda/apis/up-gateway-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oanda/apis/up-gateway-v1/revisions/395d645513bf?raw)