List proofs
List saved before-and-after comparisons for completed fixes, including pending comparisons.
GET
/api/v1/brands/{brandId}/proofsreadCall the corresponding list_proofs 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/proofs" \
--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. |
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": [
{
"fixId": "f5c2e8a1-9d3b-4e7f-a0c6-1b4d7e9f2a38",
"kind": "improve_page",
"title": "Add a rates and inclusions table to the villas page",
"metric": "visibility",
"before": 0.21,
"after": null,
"change": null,
"comparable": false,
"reason": "waiting_for_after",
"doneAt": "2026-09-25T04:10:00.000Z",
"dueAt": "2026-10-09T04:10:00.000Z"
}
],
"paging": {
"limit": 50,
"offset": 0,
"hasMore": false
},
"meta": {
"generatedAt": "2026-09-26T08:15:02.114Z",
"timeZone": "Asia/Jakarta"
}
}| Field | Type | Description |
|---|---|---|
fixId | uuid | Identifier of the completed fix. |
kind | string | Kind assigned to the completed fix. |
title | string | Saved description of the suggested change. |
metric | "visibility" | "clicks" | Answer fixes compare visibility as a 0–1 fraction. Search fixes compare Google click counts. |
before | number | null | Metric from the saved before window, or null if unavailable. |
after | number | null | Metric from the after snapshot; null until captured or when unavailable. |
change | number | null | Difference between after and before, or null when the comparison is ineligible. |
comparable | boolean | Visibility: each side needs 10 answers from 3 or more questions, or 20 from fewer. Clicks need both values. A change does not prove the fix caused it. |
reason | string | null | Explains an ineligible comparison: waiting_for_after or not_enough_data. Null when comparable. |
doneAt | datetime | null | Recorded time of completion. |
dueAt | datetime | null | Earliest time the after snapshot is due, 14 days after completion, in ISO 8601 format. |
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: List page checks.