Get one problem

Overview

Get everything about a single problem: the error, the affected location and site, and the alert email that was sent.

Use this when working a problem. Its notes come from List a problem's notes.

You'll need the notification id.

Returns the full record. The first time you open one of your own problems, it's marked as opened (notified).

Prerequisites

A Partner bearer token. See Authentication.
The problem's id (notification_id), from List open problems.

Base URL

Environment	URL
Production	`https://production-api.shoutaboutus.com`
Development	`https://development-api.shoutaboutus.com`

Endpoint

GET /api/v1/partner/error-notifications/details

Authentication

Partner token

Use it only for your own partner's problems, from List open problems. A problem outside your account tree returns 404.

Rate limit

This endpoint has no rate limit.

Request parameters

Parameter	In	Type	Required	Description
`notification_id`	query	integer	Yes	The problem's id. Must exist.

Request body

None.

Request payload

None.

Response body

The payload is inside data.

Field	Type	Description
`status`	string	`success`.
`data`	object	The problem.
`data.id`	integer	The problem's id.
`data.company_id`	integer or null	Your partner id.
`data.store_id`	integer or null	The location's id.
`data.review_site_id`	integer or null	The review site's id, or `null`.
`data.type`	string or null	The kind of problem, e.g. `Poster Error: login_error`.
`data.recipients`	string or null	Who the alert email went to.
`data.subject`	string or null	What went wrong, in short.
`data.content`	string or null	The alert email's body (HTML).
`data.grouped_ids`	string or null	Ids of related alerts grouped into this one, or `null`.
`data.resolved`	boolean	Whether it's resolved.
`data.resolved_at`	string or null	When it was resolved (ISO 8601), or `null`.
`data.notified`	boolean	Whether it has been opened. Opening it here sets this to `true`.
`data.notified_at`	string or null	When it was first opened (ISO 8601), or `null`.
`data.status`	string or null	`none` or `acknowledged`.
`data.created_at`	string	When it was raised (ISO 8601).
`data.updated_at`	string	When it last changed (ISO 8601).
`data.deleted_at`	string or null	Always `null`.
`data.account_id`	integer or null	The account's id.

Response payload

{
  "data": {
    "status": "success",
    "data": {
      "id": 1215,
      "company_id": 42,
      "store_id": 3007,
      "review_site_id": 44,
      "type": "Poster Error: login_error",
      "recipients": "[email protected]",
      "subject": "Google scrape failed",
      "content": "<p>We couldn't log in to Google for Acme Coffee - Sydney.</p>",
      "grouped_ids": null,
      "resolved": false,
      "resolved_at": null,
      "notified": true,
      "notified_at": "2026-05-29T09:15:00.000000Z",
      "status": "none",
      "created_at": "2026-05-29T08:00:00.000000Z",
      "updated_at": "2026-05-29T09:15:00.000000Z",
      "deleted_at": null,
      "account_id": 5994
    }
  }
}

Examples

Success payload

See Response payload.

Error payload

404 Problem outside your account

{
  "message": "Notification not found.",
  "status": "error",
  "errors": []
}

422 Missing notification_id

{
  "message": "The notification id field is required.",
  "errors": {
    "notification_id": [
      "The notification id field is required."
    ]
  }
}

422 Problem doesn't exist

{
  "message": "The selected notification id is invalid.",
  "errors": {
    "notification_id": [
      "The selected notification id is invalid."
    ]
  }
}

Status	Meaning
`200`	The problem.
`401`	The token is missing, expired or invalid.
`404`	The problem isn't in your account tree.
`422`	`notification_id` is missing, not an integer, or doesn't exist.
`500`	Unexpected server error.

Example request

curl --request GET \
  --url "https://production-api.shoutaboutus.com/api/v1/partner/error-notifications/details?notification_id=1215" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json'

Updated 14 days ago

Did this page help you?