# getRewindCoverage

## getRewindCoverage — Archive-wide ingest coverage and gap list

> Returns the archive's coverage summary and gap list.\
> \
> \`params\` is either omitted, \`\[]\`, or \`\[\<config>]\`.<br>

```json
{"openapi":"3.0.3","info":{"title":"Rewind RPC: getRewindCoverage","version":"1.0.0"},"tags":[{"name":"Rewind","description":"Archive coverage and meta-information."}],"servers":[{"url":"https://basic.rpc.solanavibestation.com","description":"Basic tier"},{"url":"https://ultra.rpc.solanavibestation.com","description":"Ultra tier"},{"url":"https://elite.rpc.solanavibestation.com","description":"Elite tier"},{"url":"https://epic.rpc.solanavibestation.com","description":"Epic tier"}],"security":[{},{"AuthHeader":[]},{"URLParameter":[]}],"components":{"securitySchemes":{"AuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Pass `Authorization: <api-key>` on each request."},"URLParameter":{"type":"apiKey","in":"query","name":"api_key","description":"Pass `?api_key=<api-key>` on the URL."}},"schemas":{"JsonRpcEnvelope":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]}}},"GapEntry":{"type":"object","required":["fromSlot","toSlot","status"],"properties":{"fromSlot":{"type":"integer","format":"int64"},"toSlot":{"type":"integer","format":"int64"},"status":{"type":"string","enum":["missing","partial"],"description":"`missing` for archive-misses. `partial` is reserved; not emitted today."}}},"JsonRpcErrorResponse":{"type":"object","required":["jsonrpc","id","error"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"error":{"$ref":"#/components/schemas/JsonRpcError"}}},"JsonRpcError":{"type":"object","required":["code","message"],"description":"`-32602` malformed params; `-32603` internal error (transient — safe to retry).","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":true}}}},"responses":{"UnauthorizedError":{"description":"Authentication required or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcErrorResponse"}}}},"ForbiddenError":{"description":"Insufficient permissions for the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcErrorResponse"}}}},"TooManyRequestsError":{"description":"Rate limit exceeded for this tier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcErrorResponse"}}}},"InternalServerError":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcErrorResponse"}}}}}},"paths":{"/rewind":{"post":{"operationId":"getRewindCoverage","summary":"getRewindCoverage — Archive-wide ingest coverage and gap list","tags":["Rewind"],"description":"Returns the archive's coverage summary and gap list.\n\n`params` is either omitted, `[]`, or `[<config>]`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"method":{"type":"string","enum":["getRewindCoverage"]},"params":{"type":"array","description":"Empty array, or single-element array `[<config>]`.","minItems":0,"maxItems":1,"items":{"type":"object","properties":{"fromSlot":{"type":"integer","format":"int64","description":"Lower bound of the gap window. Defaults to `earliestSlot`. Clipped to `earliestSlot` if smaller."},"toSlot":{"type":"integer","format":"int64","description":"Upper bound (inclusive). Defaults to `latestSlot`. Clipped to `latestSlot` if larger."},"maxGaps":{"type":"integer","format":"int32","default":1000,"description":"Cap on returned gap ranges. Counters remain accurate when truncated."},"includeGaps":{"type":"boolean","default":true,"description":"Set `false` to skip the gap list entirely (constant-cost summary-only response)."}}}}}}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonRpcEnvelope"},{"type":"object","required":["result"],"properties":{"result":{"type":"object","required":["earliestSlot","latestSlot","slotRange","missingSlotCount","skippedSlotCount","gapPercent","truncated","filteredOwners","filteredPubkeys","note"],"properties":{"earliestSlot":{"type":"integer","format":"int64","nullable":true,"description":"Oldest ingested slot. `null` before the ingestor's first flush."},"latestSlot":{"type":"integer","format":"int64","nullable":true,"description":"Newest ingested slot. `null` before the ingestor's first flush."},"slotRange":{"type":"integer","format":"int64","nullable":true,"description":"`latestSlot - earliestSlot + 1` when both are present."},"missingSlotCount":{"type":"integer","format":"int64","description":"Total number of slots in `[fromSlot, toSlot]` with `status=missing` — genuine archive gaps."},"skippedSlotCount":{"type":"integer","format":"int64","description":"Total number of leader-skipped slots in the window. Not failures of the archive."},"gapPercent":{"type":"number","format":"double","nullable":true,"description":"`missingSlotCount / (slotRange − skippedSlotCount) * 100`. Excludes skipped slots from the denominator."},"gaps":{"type":"array","nullable":true,"description":"Contiguous archive-miss ranges. `null` when `includeGaps=false`.","items":{"$ref":"#/components/schemas/GapEntry"}},"truncated":{"type":"boolean","description":"True if the gap list was capped at `maxGaps`. `missingSlotCount` and `skippedSlotCount` remain accurate."},"filteredOwners":{"type":"array","description":"Base58 owner pubkeys for which the ingestor drops writes.","items":{"type":"string"}},"filteredPubkeys":{"type":"array","description":"Base58 specific account pubkeys that are filtered.","items":{"type":"string"}},"note":{"type":"string","description":"Human-readable reminder of the missing/skipped + filter distinction."}}}}}]}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"429":{"$ref":"#/components/responses/TooManyRequestsError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solanavibestation.com/developers/rewind/overview/getrewindcoverage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
