> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Check a Monitor Now

> Run a monitor's check now, outside its schedule.

```bash theme={null}
curl -X POST https://api.spidra.io/api/monitors/d6761e12-b011-4633-a593-fa6be2ef466c/check \
  -H "Authorization: Bearer $SPIDRA_API_KEY"
```

```json theme={null}
{ "status": "queued", "message": "Checking now. The result will show in the check history." }
```

The check runs in the background, costs what a scheduled check costs, and alerts like one. Read it with [List Monitor Checks](https://docs.spidra.io/api-reference/monitors/list-checks.md).

Once a minute per monitor at most. Sooner returns `429`:

```json theme={null}
{ "status": "error", "code": "TOO_SOON", "message": "This monitor was just checked. Try again in a minute." }
```


## OpenAPI

````yaml POST /monitors/{monitorId}/check
openapi: 3.1.0
info:
  title: Spidra API
  version: 1.0.0
  description: >-
    Public API endpoints for web scraping via Spidra. Authenticate with
    `Authorization: Bearer YOUR_API_KEY`.
servers:
  - url: https://api.spidra.io/api
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /monitors/{monitorId}/check:
    post:
      tags:
        - Monitors
      summary: Check a Monitor Now
      description: >-
        Runs a check now, outside the schedule. Costs what a scheduled check
        costs. Once a minute per monitor at most.
      parameters:
        - name: monitorId
          in: path
          required: true
          schema:
            type: string
          description: The monitor's ID.
      responses:
        '202':
          description: Queued. The result shows in the check history.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - queued
                  message:
                    type: string
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No monitor with this ID on your account (`NOT_FOUND`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Checked less than a minute ago (`TOO_SOON`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
      required:
        - status
        - message
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.