> ## Documentation Index > Fetch the complete documentation index at: https://bisibility.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List rank checks for a keyword ## OpenAPI ````yaml /openapi.snapshot.json get /keywords/{id}/rank-checks openapi: 3.1.0 info: description: >- Public REST API for bisibility keyword rank tracking. Clients may optionally declare v1 with the Bisibility-API-Version header. Resource IDs use strict v3 prefixed public IDs and list cursors are version 3. title: bisibility Public API version: 1.0.0 servers: - url: /api/v1 security: [] tags: - description: >- Discover the API contract, capabilities, health, and public provider pricing. name: discovery x-group: Discovery - description: Manage the authenticated account and personal access tokens. name: account-access x-group: Account & Access - description: Create projects and manage their core settings. name: projects x-group: Projects - description: Create, list, and revoke API keys. name: api-keys x-group: API Keys - description: Manage tracked keywords and exact keyword matching. name: keywords x-group: Keywords - description: Run rank checks and retrieve rank-check history. name: rank-checks x-group: Rank Checks - description: Research keywords, metrics, locations, and ranked keyword suggestions. name: keyword-research x-group: Keyword Research - description: Analyze backlinks and page through backlink snapshots. name: backlinks x-group: Backlinks - description: Analyze domain visibility and load its history, keywords, and pages. name: domain-overview x-group: Domain Overview - description: Read project analytics, traffic snapshots, and search-performance data. name: analytics x-group: Analytics - description: Manage alert rules, triggered alerts, and notification preferences. name: alerts x-group: Alerts - description: Manage project competitors. name: competitors x-group: Competitors - description: Inspect and configure project sitemap monitoring. name: sitemap-monitoring x-group: Sitemap Monitoring - description: Save keywords for later without putting them under rank tracking. name: saved-keywords x-group: Saved Keywords - description: Create, list, and delete saved views. name: saved-views x-group: Saved Views - description: Ingest and list project signals. name: signals x-group: Signals - description: Connect and configure external providers. name: providers x-group: Providers - description: Create and manage webhook endpoints. name: webhooks x-group: Webhooks - description: Manage team members and invitations. name: team x-group: Team - description: Manage migration tokens and instance import sessions. name: migration x-group: Migration paths: /keywords/{id}/rank-checks: get: tags: - rank-checks summary: List rank checks for a keyword operationId: listRankChecks parameters: - description: >- API contract version requested by the client. Omit this header to use the current backward-compatible behavior. in: header name: Bisibility-API-Version required: false schema: enum: - v1 type: string - description: Maximum rank checks to return. Defaults to 50. in: query name: limit schema: default: 50 maximum: 200 minimum: 1 type: integer - description: >- Opaque v3 cursor returned as meta.next_cursor from the previous page. in: query name: cursor schema: type: string - description: Filter by persisted rank-check status. in: query name: status schema: enum: - completed - failed - running type: string - description: Return checks at or after this ISO-8601 date-time. in: query name: since schema: format: date-time type: string - description: Return checks at or before this ISO-8601 date-time. in: query name: until schema: format: date-time type: string - $ref: '#/components/parameters/ProjectHeader' - $ref: '#/components/parameters/ProjectQuery' responses: '200': content: application/json: schema: properties: data: items: $ref: '#/components/schemas/RankCheck' type: array meta: properties: next_cursor: type: - string - 'null' required: - next_cursor type: object required: - data - meta type: object description: JSON response '400': content: application/json: schema: $ref: '#/components/schemas/Problem' description: Bad request '401': content: application/json: schema: $ref: '#/components/schemas/Problem' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Problem' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/Problem' description: Not found '409': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: Unsupported API version '429': content: application/json: schema: $ref: '#/components/schemas/Problem' description: Rate limited security: - ProjectApiKey: [] - PersonalAccessToken: [] components: parameters: ProjectHeader: description: >- Project public ID (prj_...) targeted by this personal-access-token request. Optional. Selection precedence is: {project_id} path parameter, X-Bisibility-Project header, project query parameter, then inference when the PAT owner belongs to exactly one project. Project API keys and paths that already carry a project ID ignore it. in: header name: X-Bisibility-Project required: false schema: type: string ProjectQuery: description: >- Query-parameter equivalent of the X-Bisibility-Project header for personal-access-token project selection. Optional. Selection precedence is: {project_id} path parameter, X-Bisibility-Project header, project query parameter, then inference when the PAT owner belongs to exactly one project. in: query name: project required: false schema: type: string schemas: RankCheck: properties: attempts: description: >- Provider fallback attempts recorded before the final rank-check status. items: properties: message: type: string provider: type: string required: - provider - message type: object type: - array - 'null' checked_at: format: date-time type: string cost_cents: type: - number - 'null' error: type: - string - 'null' id: example: check_a00000000000000000000000 pattern: ^check_[a-z][a-z0-9]{23}$ type: string keyword_id: example: kw_a00000000000000000000000 pattern: ^kw_[a-z][a-z0-9]{23}$ type: string position: type: - integer - 'null' previous_position: type: - integer - 'null' provider: type: string ranking_url: type: - string - 'null' status: enum: - completed - failed - running type: string required: - id - keyword_id - checked_at - position - previous_position - provider - ranking_url - cost_cents - attempts - error - status type: object Problem: properties: detail: type: string docs_url: type: string errors: {} instance: type: string status: type: integer title: type: string type: type: string required: - type - title - status - detail - instance - docs_url type: object securitySchemes: ProjectApiKey: bearerFormat: bsb_key_live_... description: >- Project-scoped API key. It cannot access account routes or create additional projects. scheme: bearer type: http PersonalAccessToken: bearerFormat: bsb_pat_live_... description: >- Personal access token for account routes and projects visible to the authenticated user. scheme: bearer type: http ````