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

# Fast Check

> Quickly assesses URL safety without performing a full scan. 
    Returns malicious score and classification (SAFE, MALICIOUS, or UNRATED) based on existing intelligence and heuristics. Ideal for real-time URL validation.



## OpenAPI

````yaml POST /v1/fast-check
openapi: 3.1.0
info:
  title: urlDNA API
  description: >-
    urlDNA API documentation. This API allows you to scan, analyze, and retrieve
    insights about URLs, helping to detect potential threats such as phishing,
    malware, and scams.
  version: 1.0.0
servers:
  - url: https://api.urldna.io
security: []
paths:
  /v1/fast-check:
    post:
      tags:
        - Fast Check
      summary: Post fast check
      description: |-
        Quickly assesses URL safety without performing a full scan. 
            Returns malicious score and classification (SAFE, MALICIOUS, or UNRATED) based on existing intelligence and heuristics. Ideal for real-time URL validation.
      operationId: fast_check_v1_fast_check_post
      parameters:
        - name: authorization
          in: header
          required: true
          schema:
            type: string
            title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FastCheckRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastCheck'
        '401':
          description: 'Unauthorized: API Key is missing or invalid.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '405':
          description: >-
            Method Not Allowed: The requested HTTP method is not supported for
            this endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '422':
          description: 'Unprocessable Entity: The request body or parameters are invalid.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '429':
          description: 'Too Many Requests: Rate limit exceeded.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
        '500':
          description: 'Internal Server Error: An unexpected error occurred.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
components:
  schemas:
    FastCheckRequest:
      properties:
        url:
          type: string
          maxLength: 500
          minLength: 10
          format: uri
          title: Url
      type: object
      required:
        - url
      title: FastCheckRequest
    FastCheck:
      properties:
        malicious_score:
          type: number
          title: Malicious Score
          description: >-
            Numerical score (0-1) indicating likelihood of malicious intent.
            Higher values indicate greater risk.
        url:
          type: string
          title: Url
          description: The URL that was checked.
        scan_id:
          type: string
          title: Scan Id
          description: >-
            Scan ID associated with the checked URL. This attribute is omitted
            if the URL is not present in the system.
        status:
          $ref: '#/components/schemas/FastCheckStatusEnum'
          description: >-
            URL classification: SAFE (verified benign), MALICIOUS (threat
            detected), UNRATED (insufficient data).
      type: object
      required:
        - malicious_score
        - url
        - status
      title: FastCheck
    APIError:
      properties:
        detail:
          type: string
          title: Detail
          example: Error description message
      type: object
      required:
        - detail
      title: APIError
    FastCheckStatusEnum:
      type: string
      enum:
        - SAFE
        - MALICIOUS
        - UNRATED
      title: FastCheckStatusEnum

````