SPsponsorunited
News

List the global news submissions queue (all submitters)

Returns submissions from every reporter by default. Pass reporter_id to scope to one submitter. Requires the view-news permission.

get/api/news/submissions

Request

Query parameters

pageinteger
per_pageinteger
statusstring

Comma-separated list of statuses (e.g. pending,analysed,published,unpublished,declined). Passing 'declined' includes soft-deleted (recoverable) declined articles.

order_by'created_at' | 'updated_at' | 'published_at' | 'title' | 'status' | 'url'
order_direction'asc' | 'desc'
reporter_idinteger

Optional. Scope the queue to a single submitter's submissions.

fromstring date

Filter submissions created on or after this date (Y-m-d)

tostring date

Filter submissions created on or before this date (Y-m-d, inclusive)

titlestring

Filter by article title (case-insensitive substring). Combined with url, both must match (AND).

urlstring

Filter by article URL (case-insensitive substring). Combined with title, both must match (AND).

news_tag_ids[]integer[]

Return only articles carrying at least one of these news tags (OR between ids). Backs the queue's tag-filtered tabs. Combines with every other filter as AND.

Response

Simple paginator JSON; data items are NewsSubmissionResource rows.

current_pageinteger
first_page_urlstring nullable
frominteger nullable
next_page_urlstring nullable
pathstring
per_pageinteger
prev_page_urlstring nullable
tointeger nullable

Example response

{
  "data": [
    {
      "funding": {
        "amount_raised": {
          "raw": "$12.5M",
          "value": 12500000,
          "currency": "USD",
          "usd": 12500000
        },
        "valuation": {
          "raw": "$12.5M",
          "value": 12500000,
          "currency": "USD",
          "usd": 12500000
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.