List fixes
List suggested brand changes in rank-score order, with status and relative impact labels.
GET
/api/v1/brands/{brandId}/fixesreadCall 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
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
brandId | path | Yes | uuid | An active brand ID returned by the brand list. |
status | query | No | string | Filter by open, accepted, done or dismissed. Default todo includes open and accepted fixes; all includes every state. |
kind | query | No | string | Restrict results to one of the kinds documented below. |
limit | query | No | integer | Page size from 1 to 100; defaults to 50. |
offset | query | No | integer | Number 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"
}
}| Field | Type | Description |
|---|---|---|
id | uuid | Unique identifier for the fix. |
kind | string | Answer-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. |
kindLabel | string | Display label for the kind, such as “Improve a page”. |
status | string | Current lifecycle state: open, accepted, done or dismissed. |
impact | string | Relative 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. |
title | string | Suggested change to make. |
why | string | Brief reason derived from the fix group’s evidence. |
pageUrl | string | null | Page associated with the suggested change. |
engine | string | null | Engine associated with the saved answer behind the fix. |
questionId | uuid | null | Linked question, when one exists. |
createdAt | datetime | Timestamp when the fix was created. |
doneAt | datetime | null | Completion 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 inerrors.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 theRetry-Afterdelay 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.