---
title: "Get News Item By Uuid"
url: "https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311/operations/get_news_item_by_uuid_v2_news__uuid__get"
---

> Full API specification: https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311.md

# Get News Item By Uuid

`GET` `/v2/news/{uuid}`

Operation ID: `get_news_item_by_uuid_v2_news__uuid__get`

Get the full content for a specific news article by UUID.

## Path parameters

- `uuid` (string, uuid, required)

## Responses

- `200` - Successful Response
- `404` - `news_item_not_found`
- `422` - Validation Error
- `500` - An unexpected error occurred

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: 9fin News & Content API - v2
  version: 0.3.38
servers:
  - url: https://api.9fin.com
    description: prod
paths:
  /v2/news/{uuid}:
    get:
      tags: []
      summary: Get News Item By Uuid
      description: Get the full content for a specific news article by UUID.
      operationId: get_news_item_by_uuid_v2_news__uuid__get
      parameters:
        - name: uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Uuid
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NewsItem"
        "404":
          description: "`news_item_not_found`"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NewsItemNotFoundResponse"
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HTTPValidationError"
        "500":
          description: An unexpected error occurred
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/InternalServerErrorResponse"
security:
  - BearerAuth: []
components:
  schemas:
    NewsItem:
      properties:
        uuid:
          type: string
          title: Uuid
          description: Unique identifier for the news headline.
          examples:
            - 3fa85f64-5717-4562-b3fc-2c963f66afa6
        title:
          type: string
          title: Title
          description: Headline title text.
          examples:
            - Acme Corp announces refinancing of senior notes
        url:
          type: string
          title: Url
          description: URL of the article, pointing to the source (third-party or 9fin).
          examples:
            - https://example.com/news/acme-refinancing
        source:
          $ref: "#/components/schemas/SourceObject"
          description: Origin of the content, either 9fin or a third-party publisher.
        entities:
          $ref: "#/components/schemas/EntitiesObject"
          description: Companies and entities referenced by the headline, split into the
            main entity and any additional ones.
        regions:
          items:
            type: string
          type: array
          title: Regions
          description: Geographic regions the event or entity is tagged with.
          examples:
            - - APAC
              - CEEMEA
              - LATAM
              - North America
              - US
              - Europe
              - Western Europe
        industry:
          $ref: "#/components/schemas/IndustryObject"
          description: The industry the event is associated with.
          examples:
            - Banks
            - Financial Services
        content_tags:
          items:
            $ref: "#/components/schemas/ContentTagObject"
          type: array
          title: Content Tags
          description: Content tags categorising the headline by topic and vertical.
        published_at:
          type: string
          format: date-time
          title: Published At
          description: Timestamp when the headline was originally published (UTC).
        processed_at:
          type: string
          format: date-time
          title: Processed At
          description: Timestamp when the headline was processed by the news pipeline (UTC).
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Timestamp when the headline was last updated (UTC).
        content:
          anyOf:
            - $ref: "#/components/schemas/ContentObject"
            - type: "null"
      type: object
      required:
        - uuid
        - title
        - url
        - source
        - entities
        - regions
        - industry
        - content_tags
        - published_at
        - processed_at
        - updated_at
      title: NewsItem
    NewsItemNotFoundResponse:
      properties:
        message:
          type: string
          title: Message
        trace_id:
          anyOf:
            - type: string
            - type: "null"
          title: Trace Id
      type: object
      required:
        - message
        - trace_id
      title: NewsItemNotFoundResponse
      examples:
        - message: The supplied news item ID could not be found.
          trace_id: 202bde256c7d446f9623efdc96286c5d
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: "#/components/schemas/ValidationError"
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    InternalServerErrorResponse:
      properties:
        error_code:
          type: string
          title: Error Code
          examples:
            - internal_server_error
        message:
          type: string
          title: Message
          examples:
            - An unexpected error occurred.
        trace_id:
          anyOf:
            - type: string
            - type: "null"
          title: Trace Id
          examples:
            - e7dfd20231374d308f04655eb0538be4
      type: object
      required:
        - error_code
        - message
        - trace_id
      title: InternalServerErrorResponse
    SourceObject:
      properties:
        type:
          $ref: "#/components/schemas/ContentSource"
      type: object
      required:
        - type
      title: SourceObject
    EntitiesObject:
      properties:
        main:
          anyOf:
            - $ref: "#/components/schemas/MainEntityObject"
            - type: "null"
        additional:
          items:
            $ref: "#/components/schemas/AdditionalEntityObject"
          type: array
          title: Additional
      type: object
      required:
        - additional
      title: EntitiesObject
    IndustryObject:
      properties:
        name:
          anyOf:
            - type: string
            - type: "null"
          title: Name
      type: object
      title: IndustryObject
    ContentTagObject:
      properties:
        tag_name:
          type: string
          title: Tag Name
        vertical_name:
          type: string
          title: Vertical Name
      type: object
      required:
        - tag_name
        - vertical_name
      title: ContentTagObject
    ContentObject:
      properties:
        format:
          $ref: "#/components/schemas/ContentFormat"
        body:
          type: string
          title: Body
      type: object
      required:
        - format
        - body
      title: ContentObject
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ContentSource:
      type: string
      enum:
        - 9fin
        - third-party
      title: ContentSource
    MainEntityObject:
      properties:
        nf_id:
          type: string
          title: Nf Id
        name:
          anyOf:
            - type: string
            - type: "null"
          title: Name
        country_code:
          anyOf:
            - type: string
            - type: "null"
          title: Country Code
      type: object
      required:
        - nf_id
      title: MainEntityObject
    AdditionalEntityObject:
      properties:
        nf_id:
          type: string
          title: Nf Id
        name:
          anyOf:
            - type: string
            - type: "null"
          title: Name
      type: object
      required:
        - nf_id
      title: AdditionalEntityObject
    ContentFormat:
      type: string
      enum:
        - html
        - mkd
      title: ContentFormat
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: "**[How to get an access
        token](https://console.9fin.com/getting-started/consume-api)**"
```