> ## 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.

# User Agents

> Returns a curated list of user agent strings that can be used when submitting scans. 
    Each user agent includes browser type, device category, and market share data to help select realistic scanning profiles.



## OpenAPI

````yaml GET /v1/user-agents
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/user-agents:
    get:
      tags:
        - User Agents
      summary: List user agents
      description: >-
        Returns a curated list of user agent strings that can be used when
        submitting scans. 
            Each user agent includes browser type, device category, and market share data to help select realistic scanning profiles.
      operationId: user_agents_v1_user_agents_get
      parameters:
        - name: authorization
          in: header
          required: true
          schema:
            type: string
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserAgent'
                title: Response User Agents V1 User Agents Get
        '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: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '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:
    UserAgent:
      properties:
        user_agent:
          type: string
          title: User Agent
          description: Complete user agent string representing the browser or device.
        browser:
          type: string
          title: Browser
          description: Browser name (e.g., Chrome, Firefox, Safari).
        share:
          type: number
          title: Share
          description: Market share percentage of this user agent among internet users.
        device:
          $ref: '#/components/schemas/DeviceEnum'
          description: The device type simulated during the scan.
      type: object
      required:
        - user_agent
        - browser
        - share
        - device
      title: UserAgent
    APIError:
      properties:
        detail:
          type: string
          title: Detail
          example: Error description message
      type: object
      required:
        - detail
      title: APIError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DeviceEnum:
      type: string
      enum:
        - DESKTOP
        - MOBILE
      title: DeviceEnum
    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

````