> ## Documentation Index > Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Read Verify schedule occurrences > Lists occurrences of one Verify schedule. Requires coding_agent:read. Follow next_cursor with the same repository, schedule and limit. > [tab] CLI Tool > > ```bash > coderabbit api request "/verify/repositories/$REPOSITORY_ID/schedules/$SCHEDULE_ID/history" > ``` > > To install and sign in to the CLI, see [Call from the CLI](https://docs.coderabbit.ai/api/cli.md). > [tab] MCP Server > > An agent connected to the [CodeRabbit MCP server](https://docs.coderabbit.ai/api/mcp.md) runs this operation as the `get_verify_schedule_history` tool. The connection selects the organization, so the arguments have no `org_id` or `org_name`. > > ```json > { > "method": "tools/call", > "params": { > "name": "get_verify_schedule_history", > "arguments": { > "repository_id": "", > "schedule_id": "" > } > } > } > ``` ## OpenAPI ````yaml /openapi.json get /v1/verify/repositories/{repository_id}/schedules/{schedule_id}/history openapi: 3.0.0 info: title: CodeRabbit API version: 1.0.0 description: >- Read and manage CodeRabbit reviews, coding tasks, Verify, Triage, security findings, Knowledge Base, configuration, and users for your organization. servers: - url: https://api.coderabbit.ai description: US region - url: https://api.eu.coderabbit.ai description: EU region security: - ApiKeyAuth: [] tags: - name: Organizations and repositories - name: Pull requests and reviews - name: Coding Agent - name: Coding environments - name: Verify - name: Triage - name: Security - name: Knowledge Base - name: Automations - name: Reports - name: Configuration - name: Connections - name: Users and roles - name: Usage and metrics paths: /v1/verify/repositories/{repository_id}/schedules/{schedule_id}/history: get: tags: - Verify summary: Read Verify schedule occurrences description: >- Lists occurrences of one Verify schedule. Requires coding_agent:read. Follow next_cursor with the same repository, schedule and limit. operationId: get_verify_schedule_history parameters: - name: repository_id in: path required: true schema: type: string format: uuid description: >- Verify registration UUID returned as id by list_verify_repositories; not the provider repository ID. - name: schedule_id in: path required: true schema: type: string format: uuid - name: org_id in: query schema: type: string minLength: 1 description: >- Organization for a workspace key: the Git-provider organization ID (scope.provider_organization_id) or the CodeRabbit organization ID (scope.id, or id from list organizations). Supply either org_id or org_name, never both. Omit for organization keys and MCP connections. allowEmptyValue: true allowReserved: true - name: org_name in: query schema: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9-]{0,38}$ description: >- GitHub organization login, such as coderabbitai, not its display name. Matched case-insensitively within the authenticated workspace. Supply either org_name or org_id, never both; omit for organization keys and MCP connections. allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string minLength: 1 maxLength: 4096 description: >- Opaque continuation returned by this operation. Reuse with the same organization, filters and limit; continue even through empty pages. allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 20 allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid schedule_id: type: string format: uuid scheduled_at: type: string format: date-time status: enum: - pending - dispatched - skipped - failed type: string reason: anyOf: - enum: - no_matching_journeys - journeys_unavailable - overlap - environment_unavailable - branch_unavailable - access_denied - billing_denied - configuration_changed type: string - type: string nullable: true enum: - null job_id: anyOf: - type: string format: uuid - type: string nullable: true enum: - null resolved_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null job_status: anyOf: - type: string - type: string nullable: true enum: - null configuration: type: object properties: name: type: string maxLength: 200 default: '' selection: anyOf: - type: object properties: kind: enum: - journeys cuj_ids: type: array minItems: 1 maxItems: 50 items: type: string format: uuid required: - kind - cuj_ids - type: object properties: kind: enum: - tags tags: type: array maxItems: 50 items: type: string minLength: 1 maxLength: 100 required: - kind - tags additionalProperties: false branch: type: string minLength: 1 maxLength: 255 environment_id: type: string format: uuid timezone: type: string minLength: 1 maxLength: 100 recurrence: anyOf: - type: object properties: kind: enum: - interval minutes: type: integer minimum: 15 maximum: 525600 required: - kind - minutes additionalProperties: false - type: object properties: kind: enum: - calendar hour: type: integer minimum: 0 maximum: 23 minute: type: integer minimum: 0 maximum: 59 weekdays: type: array minItems: 1 maxItems: 7 items: type: integer minimum: 1 maximum: 7 day_of_month: type: integer minimum: 1 maximum: 31 required: - kind - hour - minute - weekdays additionalProperties: false status: enum: - active - paused type: string issue_creation: enum: - 'off' - bugs - bugs_and_blockers type: string required: - selection - branch - environment_id - timezone - recurrence - status required: - id - schedule_id - scheduled_at - status - reason - job_id - resolved_at - job_status next_cursor: anyOf: - type: string - type: string nullable: true enum: - null description: >- Opaque continuation token; reuse with the same repository and schedule. required: - data - next_cursor '400': description: Bad request content: application/json: schema: type: object properties: error: type: object properties: code: enum: - invalid_request type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: object properties: code: enum: - unauthenticated type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: Forbidden content: application/json: schema: type: object properties: error: type: object properties: code: enum: - forbidden type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '404': description: Not found content: application/json: schema: type: object properties: error: type: object properties: code: enum: - not_found type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '409': description: Conflict content: application/json: schema: type: object properties: error: type: object properties: code: enum: - head_changed - conflict type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '412': description: Precondition failed content: application/json: schema: type: object properties: error: type: object properties: code: enum: - precondition_failed type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: Content too large content: application/json: schema: type: object properties: error: type: object properties: code: enum: - payload_too_large type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: Too many requests content: application/json: schema: type: object properties: error: type: object properties: code: enum: - rate_limit_exceeded type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: Internal server error content: application/json: schema: type: object properties: error: type: object properties: code: enum: - internal_error type: string message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: Service unavailable content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unavailable message: type: string retry_after: type: integer minimum: 0 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-coderabbitai-api-key description: >- See [Authentication](/api/authentication) for the key types and where to create a key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.