Autohost

Autohost Lookup API

The Lookup API from Autohost — 12 operation(s) for lookup.

GitHub OpenAPI

Operations 12

GET /lookup/phone/{number} Lookup phone number #
POST /lookup/social Lookup social accounts #
GET /lookup/breaches/{email} Lookup breaches by email #
GET /lookup/whois/{domain} Lookup whois records by domain #
GET /lookup/domain/{domain} Lookup company details by domain #
GET /lookup/geoip/{ip} Lookup geo-location by IP #
GET /lookup/sexoffender Lookup sex offenders #
GET /lookup/watchlist Lookup global watchlist #
GET /lookup/geocode/{address} Lookup postal address #
GET /lookup/ip-threats/{ip} Lookup IP Threats #
GET /lookup/adverse-media/results/{id} Adverse Media Report #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/autohost/openapi/autohost-lookup-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-summary-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-payment-event-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-screens-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-background-check-results-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-payments-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/autohost:autohost-lookup-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

autohost-lookup-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Autohost Lookup API
  version: '1'
  description: 'Operations tagged Lookup across 2 of this provider''s published API definitions: autohost-openapi.json, developer.autohost.ai_openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Lookup
paths:
  /lookup/phone/{number}:
    get:
      operationId: lookup-phone
      summary: Lookup phone number
      description: Lookup line type and carrier
      parameters:
      - name: number
        in: path
        description: URL-encoded phone number in international format (e.g. +441234567890)
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Phone validation results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupPhoneResponse'
              examples:
                Simple:
                  value:
                    countryCode: US
                    phoneNumber: '+1234567890'
                    nationalFormat: (123) 456-7890
                    carrier:
                      name: Verizon
                      type: mobile
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupPhoneResponse'
              examples:
                Simple:
                  value:
                    countryCode: US
                    phoneNumber: '+1234567890'
                    nationalFormat: (123) 456-7890
                    carrier:
                      name: Verizon
                      type: mobile
      tags:
      - Lookup
  /lookup/social:
    post:
      operationId: lookup-social
      summary: Lookup social accounts
      description: Lookup social accounts by email and phone number to Check users are not using fake profiles by validating they have online social accounts
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookupSocialRequest'
        description: Transaction details object
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Phone validation results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupSocialResponse'
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupSocialResponse'
      tags:
      - Lookup
  /lookup/breaches/{email}:
    get:
      operationId: lookup-breaches
      summary: Lookup breaches by email
      description: Discover how many times a user has been compromised
      parameters:
      - name: email
        in: path
        description: URL encoded email address
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Breaches results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupBreachesResponse'
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupBreachesResponse'
      tags:
      - Lookup
  /lookup/whois/{domain}:
    get:
      operationId: lookup-whois
      summary: Lookup whois records by domain
      description: Discover who owns a domain
      parameters:
      - name: domain
        in: path
        description: domain name (e.g. google.com)
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Whois results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupWhoisResponse'
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupWhoisResponse'
      tags:
      - Lookup
  /lookup/domain/{domain}:
    get:
      operationId: lookup-domain
      summary: Lookup company details by domain
      description: Find company details by domain
      parameters:
      - name: domain
        in: path
        description: domain name (e.g. oracle.com)
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupDomainCompanyResponse'
              examples:
                Simple:
                  value:
                  - name: Google
                    country: US
                    industry: Internet
                    size: 1000+ employees
                    linkedin_url: https://www.linkedin.com/company/google
                    founded: '1998'
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupDomainCompanyResponse'
              examples:
                Simple:
                  value:
                  - name: Google
                    country: US
                    industry: Internet
                    size: 1000+ employees
                    linkedin_url: https://www.linkedin.com/company/google
                    founded: '1998'
      tags:
      - Lookup
  /lookup/geoip/{ip}:
    get:
      operationId: lookup-geoip
      summary: Lookup geo-location by IP
      description: Find location details by IP address
      parameters:
      - name: ip
        in: path
        description: IP Address
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupGeoipResponse'
              examples:
                Simple:
                  value:
                    country_code: US
                    country_name: United States
                    city: Mountain View
                    postal_code: '94043'
                    time_zone_name: America/Los_Angeles
                    latitude: 37.4192
                    longitude: -122.0574
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupGeoipResponse'
              examples:
                Simple:
                  value:
                    country_code: US
                    country_name: United States
                    city: Mountain View
                    postal_code: '94043'
                    time_zone_name: America/Los_Angeles
                    latitude: 37.4192
                    longitude: -122.0574
      tags:
      - Lookup
  /lookup/sexoffender:
    get:
      operationId: lookup-sexoffender
      summary: Lookup sex offenders
      description: Search sex offenders in the USA
      parameters:
      - name: fname
        in: query
        description: First name
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: lname
        in: query
        description: Last name
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: dob
        in: query
        description: Date of birth (YYYY-MM-DD)
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: state
        in: query
        description: State (e.g. CA)
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupSexOffenderResponse'
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupSexOffenderResponse'
      tags:
      - Lookup
  /lookup/watchlist:
    get:
      operationId: lookup-watchlist
      summary: Lookup global watchlist
      description: Search entities in the Global Watchlist list by name, date of birth and aliases
      parameters:
      - name: name
        in: query
        description: Full name or alias
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: dob
        in: query
        description: Date of birth (YYYY-MM-DD)
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: yob
        in: query
        description: Year of birth (YYYY)
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: country_code
        in: query
        description: Country code (e.g. US)
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: from
        in: query
        description: 'Pagination start (default: 0)'
        required: false
        allowEmptyValue: false
        schema:
          type: number
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupWatchlistResponse'
              examples:
                Simple:
                  value:
                    dob:
                    - '1961-04-25'
                    yob:
                    - 1961
                    full_name: maria soledad iparraguirre guenechea
                    first_name: maria
                    last_name: iparraguirre guenechea
                    middle_name: soledad
                    description: Member ETA.
                    aliases:
                    - maria soledad iparraguirre guenechea
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Lookup
  /lookup/geocode/{address}:
    get:
      operationId: lookup-address
      summary: Lookup postal address
      description: Lookup or verify billing and shipping addresses
      parameters:
      - name: address
        in: path
        description: Street or mailing address (URL-encoded)
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupAddressResponse'
              examples:
                Simple:
                  value:
                    address: 123 Main St
                    street: 123 Main St
                    city: Mountain View
                    state: CA
                    country: US
                    country_code: US
                    zipcode: '94043'
                    timezone: America/Los_Angeles
                    geo:
                      lat: 37.4192
                      lon: -122.0574
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupAddressResponse'
              examples:
                Simple:
                  value:
                    address: 123 Main St
                    street: 123 Main St
                    city: Mountain View
                    state: CA
                    country: US
                    country_code: US
                    zipcode: '94043'
                    timezone: America/Los_Angeles
                    geo:
                      lat: 37.4192
                      lon: -122.0574
      tags:
      - Lookup
  /lookup/ip-threats/{ip}:
    get:
      operationId: lookup-ip
      summary: Lookup IP Threats
      description: Lookup threat reports associated with an IP address
      parameters:
      - name: ip
        in: path
        description: IP Address
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Lookup results object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupIPThreatsResponse'
              examples:
                Simple:
                  value:
                  - ip: 5.167.66.39
                    title: IP reported on blocklist.de feed
                    link: https://lists.blocklist.de/lists/
                    timestamp: '2016-01-01T00:00:00Z'
                    source: blocklist
                    tags:
                    - attack
                    - suspicious
                    reasons:
                    - The IP is blacklisted on blocklist.de
        '500':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupIPThreatsResponse'
              examples:
                Simple:
                  value:
                  - ip: 5.167.66.39
                    title: IP reported on blocklist.de feed
                    link: https://lists.blocklist.de/lists/
                    timestamp: '2016-01-01T00:00:00Z'
                    source: blocklist
                    tags:
                    - attack
                    - suspicious
                    reasons:
                    - The IP is blacklisted on blocklist.de
      tags:
      - Lookup
  /lookup/adverse-media/search:
    get:
      operationId: adverse-media-search
      summary: Adverse Media Search
      description: Initiate an adverse media search for a person or company
      parameters:
      - name: first_name
        in: query
        description: First name or alias
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: middle_name
        in: query
        description: Middle name
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: last_name
        in: query
        description: Last name or alias
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: year_of_birth
        in: query
        description: Year of birth (YYYY)
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: country
        in: query
        description: Country code (e.g. US)
        required: true
        allowEmptyValue: false
        schema:
          type: string
      - name: city
        in: query
        description: City
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: state
        in: query
        description: State code (e.g. CA)
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Search status object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdverseMediaSearchResponse'
              examples:
                Simple:
                  value:
                    id: ab48405329f526a3f43f6e9c711466f503395f86a18110641ae246df544e56f1
                    status: PENDING
                    startDate: '2023-01-01T00:00:00.000Z'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Lookup
  /lookup/adverse-media/results/{id}:
    get:
      operationId: adverse-media-report
      summary: Adverse Media Report
      description: View results of an adverse media search for a person or company
      parameters:
      - name: id
        in: path
        description: Report ID
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Search status object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdverseMediaReportResponse'
              examples:
                Simple:
                  value:
                    id: ab48405329f526a3f43f6e9c711466f503395f86a18110641ae246df544e56f1
                    status: FINISHED
                    startDate: '2023-01-01T00:00:00.000Z'
                    stopDate: '2023-01-01T00:10:00.000Z'
                    riskCategories:
                    - Discrimination
                    - Fraud or Financial Crime
                    - Harassment
                    - Violence
                    - Conflicts or Litigation
                    - Other News
                    findings:
                    - title: Title of the news article
                      snippet: Snippet of the news article
                      summary: Summary of the news article
                      displayLink: example.com
                      link: https://www.example.com/article
                      image: https://www.example.com/article/image.jpg
                      riskCategories:
                      - Discrimination
                    - title: Title of the news article
                      snippet: Snippet of the news article
                      summary: Summary of the news article
                      displayLink: example.com
                      link: https://www.example.com/article
                      image: https://www.example.com/article/image.jpg
                      riskCategories:
                      - Fraud or Financial Crime
                      - Harassment
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Lookup
components:
  schemas:
    LookupIPThreatsResponse:
      type: array
      items:
        type: object
        properties:
          ip:
            type: string
          title:
            type: string
          link:
            type: string
          timestamp:
            type: string
          source:
            type: string
          tags:
            type: array
            items:
              type: string
          reasons:
            type: array
            items:
              type: string
    LookupBreachesResponse:
      type: array
      items:
        type: object
        properties:
          Name:
            type: string
          Domain:
            type: string
          BreachDate:
            type: string
    LookupWatchlistResponse:
      properties:
        from:
          type: number
        size:
          type: number
        total:
          type: number
        items:
          type: array
          items:
            type: object
            properties:
              info:
                type: string
              full_name:
                type: string
              first_name:
                type: string
              last_name:
                type: string
              middle_name:
                type: string
              description:
                type: string
              yob:
                type: array
                items:
                  type: number
              dob:
                type: array
                items:
                  type: string
              aliases:
                type: array
                items:
                  type: string
    AdverseMediaReportResponse:
      properties:
        id:
          type: string
        status:
          type: string
          enum:
          - PENDING
          - NO_RESULTS
          - REVIEW
          - FINISHED
        riskCategories:
          type: array
          items:
            type: string
        findings:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
              snippet:
                type: string
              summary:
                type: string
              displayLink:
                type: string
              link:
                type: string
                format: uri
              image:
                type: string
                format: uri
              riskCategories:
                type: array
                items:
                  type: string
        startDate:
          type: string
          format: date-time
        stopDate:
          type: string
          format: date-time
    LookupSexOffenderResponse:
      properties:
        from:
          type: number
        size:
          type: number
        total:
          type: number
        items:
          type: array
          items:
            type: object
            properties:
              fname:
                type: string
              lname:
                type: string
              city:
                type: string
              state:
                type: string
              zip:
                type: string
              dob:
                type: string
              charge:
                type: array
                items:
                  type: string
    LookupPhoneResponse:
      properties:
        countryCode:
          type: string
        phoneNumber:
          type: string
        nationalFormat:
          type: string
        error:
          type: string
        carrier:
          type: object
          properties:
            name:
              type: string
            type:
              type: string
    LookupAddressResponse:
      properties:
        address:
          type: string
        street:
          type: string
        city:
          type: string
        state:
          type: string
        country:
          type: string
        country_code:
          type: string
        zipcode:
          type: string
        timezone:
          type: string
        geo:
          type: object
          properties:
            lat:
              type: number
            lon:
              type: number
    LookupWhoisResponse:
      type: array
      items:
        type: object
        properties:
          server:
            type: string
          data:
            type: object
            properties:
              domainName:
                type: string
              registrar:
                type: string
              creationDate:
                type: string
              expirationDate:
                type: string
    ErrorResponse:
      properties:
        error:
          type: string
    LookupSocialResponse:
      properties:
        phoneNumber:
          type: object
          properties:
            accountDetails:
              type: object
              properties:
                facebook:
                  type: object
                  properties:
                    registered:
                      type: boolean
                google:
                  type: object
                  properties:
                    registered:
                      type: boolean
        email:
          type: object
    AdverseMediaSearchResponse:
      properties:
        id:
          type: string
        status:
          type: string
          enum:
          - PENDING
          - NO_RESULTS
          - REVIEW
          - FINISHED
        startDate:
          type: string
          format: date-time
    LookupDomainCompanyResponse:
      type: array
      items:
        type: object
        properties:
          name:
            type: string
          country:
            type: string
          industry:
            type: string
          size:
            type: string
          linkedin_url:
            type: string
          founded:
            type: string
    LookupGeoipResponse:
      type: array
      items:
        type: object
        properties:
          country_code:
            type: string
          country_name:
            type: string
          city:
            type: string
          postal_code:
            type: string
          time_zone_name:
            type: string
          latitude:
            type: number
          longitude:
            type: number
    LookupSocialRequest:
      properties:
        email:
          type: string
          format: email
        phoneNumber:
          type: string
x-refined-from:
- autohost-openapi.json
- developer.autohost.ai_openapi.json