Browse all documentation

List fixes

List suggested brand changes in rank-score order, with status and relative impact labels.

GET/api/v1/brands/{brandId}/fixesread

Call the corresponding list_fixes MCP tool with JSON arguments. Supply brandId and other path values as named arguments when the endpoint has them.

Request details

Required scope: A valid read or write token. Increase offset by limit for each page while paging.hasMore is true.

Request example
curl --request GET \
  --url "https://searchseal.com/api/v1/brands/b7e4c2a0-5d1f-4c8e-9a3b-2f6d8e1c4a70/fixes?status=open" \
  --header "Authorization: Bearer $SEARCHSEAL_TOKEN"

Request parameters

NameLocationRequiredTypeDescription
brandIdpathYesuuidAn active brand ID returned by the brand list.
statusqueryNostringFilter by open, accepted, done or dismissed. Default todo includes open and accepted fixes; all includes every state.
kindqueryNostringRestrict results to one of the kinds documented below.
limitqueryNointegerPage size from 1 to 100; defaults to 50.
offsetqueryNointegerNumber of preceding items to skip; defaults to 0.

Response fields

Response body example
{
  "items": [
    {
      "id": "f5c2e8a1-9d3b-4e7f-a0c6-1b4d7e9f2a38",
      "kind": "improve_page",
      "kindLabel": "Improve a page",
      "status": "open",
      "impact": "high",
      "title": "Add a rates and inclusions table to the villas page",
      "why": "AI Overview answering “best boutique hotel in ubud”",
      "pageUrl": "https://example.com/villas",
      "engine": "google_aio",
      "questionId": "e3a9d1e2-7b4c-4f60-8e2a-9c1d5b7f3e21",
      "createdAt": "2026-09-20T01:00:00.000Z",
      "doneAt": null
    }
  ],
  "paging": {
    "limit": 50,
    "offset": 0,
    "hasMore": false
  },
  "meta": {
    "generatedAt": "2026-09-26T08:15:02.114Z",
    "timeZone": "Asia/Jakarta"
  }
}
FieldTypeDescription
iduuidUnique identifier for the fix.
kindstringAnswer-based kinds: correct_fact, improve_page, get_listed, write_page. Search-based kinds: get_indexed, fix_canonical, improve_snippet, push_query, merge_pages, recover_page, add_internal_links. Site-access kinds: unblock_ai_search, fix_broken_page, unhide_page. Page-check kind: fix_page_readiness.
kindLabelstringDisplay label for the kind, such as “Improve a page”.
statusstringCurrent lifecycle state: open, accepted, done or dismissed.
impactstringRelative rank of the fix’s group within its to-do, done or dismissed bucket: high for the first third, medium for the next, low for the rest.
titlestringSuggested change to make.
whystringBrief reason derived from the fix group’s evidence.
pageUrlstring | nullPage associated with the suggested change.
enginestring | nullEngine associated with the saved answer behind the fix.
questionIduuid | nullLinked question, when one exists.
createdAtdatetimeTimestamp when the fix was created.
doneAtdatetime | nullCompletion timestamp, if the fix has been completed.

Successful REST responses from this endpoint include the shown meta fields. Read about data-through dates.

Possible errors

  • 400 invalid_request — An input failed validation. Field details may appear in errors.
  • 401 unauthorized — Authentication failed because the token is absent, unrecognized or revoked.
  • 403 forbidden — Account access or token permissions do not allow this request. Check the message for the cause.
  • 404 not_found — The resource is missing or unavailable to this account, including inactive brands.
  • 429 rate_limited — A quota was reached or could not be checked. Wait the Retry-After delay before retrying.
  • 500 server_error — The server failed to complete the operation.

For the shared error format, see status codes, quotas and retries. Next endpoint: Get fix.