openapi: 3.0.3
info:
  title: Abstract API - IP Intelligence API
  description: Detect VPNs, proxies, Tor exit nodes, abuse potential, hosting services, relays, and mobile IPs. Also provides ASN, company, location, timezone, flag, and currency data for any IP address.
  version: 1.0.0
  contact:
    url: https://www.abstractapi.com/
  x-generated-from: documentation
servers:
  - url: https://ip-intelligence.abstractapi.com/v1
    description: IP Intelligence API v1
security:
  - apiKey: []
tags:
  - name: IP Intelligence
    description: Advanced IP address intelligence and security operations
paths:
  /:
    get:
      operationId: getIPIntelligence
      summary: Abstract API Get IP Intelligence
      description: Analyze an IP address for security signals including VPN, proxy, Tor, abuse, hosting, relay, and mobile detection along with location and ASN data.
      tags:
        - IP Intelligence
      parameters:
        - name: api_key
          in: query
          description: Your unique API key for the IP Intelligence API.
          required: true
          schema:
            type: string
          example: abc123def456
        - name: ip_address
          in: query
          description: IPv4 or IPv6 address to analyze. Auto-detects request IP if omitted.
          required: false
          schema:
            type: string
          example: 8.8.8.8
        - name: fields
          in: query
          description: Comma-separated list of top-level keys to return.
          required: false
          schema:
            type: string
          example: security,location,asn
      responses:
        '200':
          description: Successful IP intelligence response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IPIntelligenceResponse'
              examples:
                getIPIntelligence200Example:
                  summary: Default getIPIntelligence 200 response
                  x-microcks-default: true
                  value:
                    ip_address: 8.8.8.8
                    security:
                      is_vpn: false
                      is_proxy: false
                      is_tor: false
                      is_hosting: true
                      is_relay: false
                      is_mobile: false
                      is_abuse: false
                    asn:
                      asn: AS15169
                      name: Google LLC
                      domain: google.com
                      type: hosting
                    company:
                      name: Google LLC
                      domain: google.com
                      type: hosting
                    domains:
                      - dns.google
                    location:
                      city: Mountain View
                      region: California
                      country: United States
                      country_code: US
                      latitude: 37.386
                      longitude: -122.0838
                    timezone:
                      name: America/Los_Angeles
                      abbreviation: PST
                      utc_offset: -8
                      local_time: '2026-04-19T10:30:00'
                      is_dst: false
                    flag:
                      emoji: "🇺🇸"
                      unicode: U+1F1FA U+1F1F8
                      png: https://static.abstractapi.com/country-flags/US_flag.png
                      svg: https://static.abstractapi.com/country-flags/US_flag.svg
                    currency:
                      name: US Dollar
                      iso_code: USD
                      symbol: $
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: api_key
  schemas:
    IPIntelligenceResponse:
      type: object
      description: Full IP intelligence response
      properties:
        ip_address:
          type: string
          description: Analyzed IP address
          example: 8.8.8.8
        security:
          $ref: '#/components/schemas/IPSecurityFlags'
        asn:
          $ref: '#/components/schemas/ASNInfo'
        company:
          $ref: '#/components/schemas/CompanyBasic'
        domains:
          type: array
          description: Known domains associated with this IP
          items:
            type: string
          example:
            - dns.google
        location:
          $ref: '#/components/schemas/LocationInfo'
        timezone:
          $ref: '#/components/schemas/TimezoneInfo'
        flag:
          $ref: '#/components/schemas/FlagInfo'
        currency:
          $ref: '#/components/schemas/CurrencyInfo'
    IPSecurityFlags:
      type: object
      description: Security classification flags for the IP
      properties:
        is_vpn:
          type: boolean
          description: IP is a known VPN endpoint
          example: false
        is_proxy:
          type: boolean
          description: IP is a known proxy server
          example: false
        is_tor:
          type: boolean
          description: IP is a Tor exit node
          example: false
        is_hosting:
          type: boolean
          description: IP belongs to a hosting or cloud provider
          example: true
        is_relay:
          type: boolean
          description: IP is used as a relay (e.g., Apple Private Relay)
          example: false
        is_mobile:
          type: boolean
          description: IP is associated with a mobile network
          example: false
        is_abuse:
          type: boolean
          description: IP has been flagged for abuse
          example: false
    ASNInfo:
      type: object
      description: Autonomous System Number information
      properties:
        asn:
          type: string
          description: ASN identifier
          example: AS15169
        name:
          type: string
          description: ASN organization name
          example: Google LLC
        domain:
          type: string
          description: Primary domain for the ASN
          example: google.com
        type:
          type: string
          description: Type of ASN (hosting, isp, business, etc.)
          example: hosting
    CompanyBasic:
      type: object
      description: Company information for the IP owner
      properties:
        name:
          type: string
          description: Company name
          example: Google LLC
        domain:
          type: string
          description: Company domain
          example: google.com
        type:
          type: string
          description: Company type
          example: hosting
    LocationInfo:
      type: object
      description: Geographic location for the IP
      properties:
        city:
          type: string
          description: City name
          example: Mountain View
        region:
          type: string
          description: Region or state
          example: California
        country:
          type: string
          description: Country name
          example: United States
        country_code:
          type: string
          description: ISO 3166-1 alpha-2 country code
          example: US
        latitude:
          type: number
          format: double
          description: Latitude
          example: 37.386
        longitude:
          type: number
          format: double
          description: Longitude
          example: -122.0838
    TimezoneInfo:
      type: object
      properties:
        name:
          type: string
          example: America/Los_Angeles
        abbreviation:
          type: string
          example: PST
        utc_offset:
          type: integer
          example: -8
        local_time:
          type: string
          example: '2026-04-19T10:30:00'
        is_dst:
          type: boolean
          example: false
    FlagInfo:
      type: object
      properties:
        emoji:
          type: string
          example: "🇺🇸"
        unicode:
          type: string
          example: U+1F1FA U+1F1F8
        png:
          type: string
          format: uri
          example: https://static.abstractapi.com/country-flags/US_flag.png
        svg:
          type: string
          format: uri
          example: https://static.abstractapi.com/country-flags/US_flag.svg
    CurrencyInfo:
      type: object
      properties:
        name:
          type: string
          example: US Dollar
        iso_code:
          type: string
          example: USD
        symbol:
          type: string
          example: $
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          example: The provided API key is invalid
        error:
          type: string
          example: invalid_api_key