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

# Add To Watchlist

> Add an entity to the watchlist for continuous monitoring.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/watchlist
openapi: 3.1.0
info:
  title: Limitguard.ai
  description: >-
    Lead validation API: the company behind each lead checked against the NL and
    BE business registers, EU VAT and sanctions lists, plus company, KYB and
    agent wallet checks for developers and AI agents
  version: 0.1.0
servers:
  - url: https://api.limitguard.ai
security: []
paths:
  /v1/watchlist:
    post:
      summary: Add To Watchlist
      description: Add an entity to the watchlist for continuous monitoring.
      operationId: add_to_watchlist_v1_watchlist_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WatchlistAddRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Add To Watchlist V1 Watchlist Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    WatchlistAddRequest:
      properties:
        entity_id:
          type: string
          maxLength: 256
          minLength: 1
          title: Entity Id
        entity_name:
          type: string
          maxLength: 256
          minLength: 1
          title: Entity Name
        reason:
          type: string
          maxLength: 500
          title: Reason
          default: ''
        rescore_interval:
          type: integer
          minimum: 3600
          title: Rescore Interval
          description: Seconds between rescores
          default: 604800
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
          description: >-
            ISO 3166-1 alpha-2 country code. With a country and at least one
            typed identifier, the entry is under change monitoring on plans that
            include it (weekly re-check, changes sent as identifier.change.new
            webhooks).
        kvk_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Kvk Number
          description: Dutch KVK number (8 digits)
        cbe_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Cbe Number
          description: Belgian CBE number
        vat_number:
          anyOf:
            - type: string
              maxLength: 20
            - type: 'null'
          title: Vat Number
          description: EU VAT number
        domain:
          anyOf:
            - type: string
              maxLength: 253
            - type: 'null'
          title: Domain
          description: Entity website domain
        wallet_address:
          anyOf:
            - type: string
              maxLength: 100
            - type: 'null'
          title: Wallet Address
          description: Crypto wallet address
        wallet_chain:
          anyOf:
            - type: string
            - type: 'null'
          title: Wallet Chain
          description: Chain of wallet_address
      type: object
      required:
        - entity_id
        - entity_name
      title: WatchlistAddRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

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