---
title: "GetHeadlinesResponse"
url: "https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311/schemas/GetHeadlinesResponse"
---

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

# GetHeadlinesResponse

## 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
components:
  schemas:
    NewsHeadline:
      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).
      type: object
      required:
        - uuid
        - title
        - url
        - source
        - entities
        - regions
        - industry
        - content_tags
        - published_at
        - processed_at
        - updated_at
      title: NewsHeadline
    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
    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
    GetHeadlinesResponse:
      properties:
        items:
          items:
            $ref: "#/components/schemas/NewsHeadline"
          type: array
          title: Items
        next_cursor:
          anyOf:
            - type: string
            - type: "null"
          title: Next Cursor
          description: Opaque cursor for fetching the next page. Pass it back unchanged as
            the `cursor` query parameter on the next request. `null` when this
            is the last page.
          examples:
            - MjAyNi0wMS0xNVQxNDozMjowMCswMDowMDozZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY=
      type: object
      required:
        - items
      title: GetHeadlinesResponse
```