Release NotesDocumentationAPI ReferenceSupportAPI StatusRoadmap
Start Building

IP Schema

A breakdown of the IP-related fields we offer

Suggest Edits

Overview

IP Enrichment API

This page details the company-related fields that we provide through the IP Enrichment API.

📘

Field Availability

Please note: Not all fields are available in all bundles.

  • For more information about data formatting, see Data Types.
  • For a full example record, see Example IP Record.
  • For a simplified overview of our IP fields, check out the IP Data Overview.
  • For more details about our IP fields and fill rates check out our IP Stats pages.
  • If you'd like access to premium fields or have questions about which fields are included in your specific field bundle(s), please speak to one of our data consultants.

IP


ip

Description Information related to the IP address.
Data Type Object

Field Details

This the object containing all information related to a particular IP we've registered in our dataset.

IP objects can include the following data:

FieldTypeDescription
ip.addressString The matched IP address.
ip.metadataObject Premium fields targeted towards identifying IPs as mobile or using hosting, proxy, Tor, VPN, relay or other services.
ip.locationObject The location associated with the IP address.

Example

"ip": {
  "address": "72.212.42.169",
  "metadata": {
    "version": 4,
    "mobile": false,
    "hosting": false,
    "proxy": false,
    "tor": false,
    "vpn": false,
    "relay": false,
    "service": null,
    "asn_domain": null
  },
  "location": {
    "name": "phoenix, arizona, united states",
    "locality": "phoenix",
    "region": "arizona",
    "metro": "phoenix, arizona",
    "country": "united states",
    "continent": "north america",
    "postal_code": "85001",
    "geo": "33.44838,-112.07404",
    "timezone": "america/phoenix"
  }
}

ip.address

Description The IP address .
Data Type String

Field Details

This is the specific IP address we have registered in our dataset

Example

"address": "72.212.42.169",

ip.metadata

Description Premium fields targeted towards identifying IPs as mobile or using hosting, proxy, Tor, VPN, relay or other services.
Data Type Object

Field Details

The metadata object is a set of premium fields targeted towards identifying IPs as mobile or using hosting, proxy, Tor, VPN, relay or other services.

Example

"metadata": {
    "version": 4,
    "mobile": false,
    "hosting": false,
    "proxy": false,
    "tor": false,
    "vpn": false,
    "relay": false,
    "service": null,
    "asn_domain": null
  }

ip.metadata.version

Description The type of IP Address (IPv4 or IPv6).
Data Type Integer (4 or 6)

Field Details

This field will only contain the integer values 4 or 6 corresponding to whether the ip.address field is a IPv4 or IPv6 address.

Example

"version": 4,

ip.metadata.mobile

Description If the IP is a known mobile address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known mobile address.

Example

"mobile": false,

ip.metadata.hosting

Description If the IP is a known hosting address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known hosting address.

Example

"hosting": false

ip.metadata.proxy

Description If the IP is a known proxy address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known proxy address.

Example

"proxy": false

ip.metadata.tor

Description If the IP is a known Tor address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known Tor address.

Example

"tor": false

ip.metadata.vpn

Description If the IP is a known VPN address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known VPN address.

Example

"vpn": false

ip.metadata.relay

Description If the IP is a known relay address.
Data Type Boolean

Field Details

A boolean field indicating whether the IP is a known relay address.

Example

"relay": false

ip.metadata.service

Description If known, the name of the service for the address.
Data Type String

Field Details

If known, this field will contain the name of the service for the address. If the service name is unknown, the field value returned will be null.

Example

"service": null

ip.metadata.asn_domain

Description The domain associated with the ASN block.
Data Type String

Field Details

If known, this field will contain the domain associated with the ASN block for this IP. If the ASN block is unknown, the field value returned will be null.

Example

"asn_domain": null

ip.location

Description The location associated with the IP address.
Data Type Object

Field Details

The location object will contain some of our common location fields as well as the location timezone:

FieldData TypeDescription
nameStringOur cleaned values for locations in the format locality, region, country.
localityString
regionString
metroEnum (String)US ONLY. These are generated based on the census-designated MSAs and maps. Will be one of our Canonical Metros.
countryEnum (String)Standardized format for country. Will be one of our Canonical Countries.
continentEnum (String)Standardized format for continent. Will be one of our Canonical Continents.
postal_codeString
geoStringCity-center geo code of a locality, in the format latitude, longitude.
timezoneEnum (String)The timezone the address is in. Will be lowercase and one of the Global Time Zone values found here.

For more information on our standard location fields, see https://docs.peopledatalabs.com/docs/data-types#locations.

Example

"location": {
  "name": "phoenix, arizona, united states",
  "locality": "phoenix",
  "region": "arizona",
  "metro": "phoenix, arizona",
  "country": "united states",
  "continent": "north america",
  "postal_code": "85001",
  "geo": "33.44838,-112.07404",
  "timezone": "america/phoenix"
}

ip.location.name

Description Our cleaned values for locations in the format locality, region, country.
Data Type String

Example

"name": "phoenix, arizona, united states"

ip.location.locality

Description The locality of the ip address
Data Type String

Example

"locality": "phoenix"

ip.location.region

Description The region of the ip address
Data Type String

Example

"region": "arizona"

ip.location.metro

Description US ONLY. These are generated based on the census-designated MSAs and maps. Will be one of our [Canonical Metros](https://docs.peopledatalabs.com/docs/location-metros).
Data Type Enum (String)

Example

"metro": "phoenix, arizona"

ip.location.country

Description Standardized format for country. Will be one of our [Canonical Countries](https://docs.peopledatalabs.com/docs/location-countries).
Data Type Enum (String)

Example

"country": "united states"

ip.location.continent

Description Standardized format for continent. Will be one of our [Canonical Continents](https://docs.peopledatalabs.com/docs/location-continents).
Data Type Enum (String)

Example

"continent": "north america"

ip.location.postal_code

Description The postal code of the ip address
Data Type String

Example

"postal_code": "85001"

ip.location.geo

Description City-center geo code of a locality, in the format latitude, longitude.
Data Type String

Example

"geo": "33.44838,-112.07404"

ip.location.timezone

Description The timezone the address is in. Will be lowercase and one of the Global Time Zone values found [here](https://docs.trifacta.com/display/DP/Supported+Time+Zone+Values).
Data Type Enum (String)

Example

"timezone": "america/phoenix"

company

Description Information related to the company associated with the IP address
Data Type Object

Field Details

Many of the fields in the data.company object come directly from our Company Schema.

Example

"company": {
  "confidence": "very high",
  "id": "tnHcNHbCv8MKeLh92946LAkX6PKg",
  "website": "peopledatalabs.com",
  "name": "people data labs",
  "display_name": "People Data Labs",
  "location": {
    "name": "san francisco, california, united states",
    "locality": "san francisco",
    "region": "california",
    "metro": "san francisco, california",
    "country": "united states",
    "continent": "north america",
    "street_address": "455 market street",
    "address_line_2": "suite 1670",
    "postal_code": "94105",
    "geo": "37.77,-122.41"	
  },
  "size": "51-200",
  "industry": "computer software",
  "inferred_revenue": "$10M-$25M",
  "employee_count": 116,
  "tags": [
    "b2b data",
    "people data",
    "data science",
    "data",
    "daas",
    "artificial intelligence",
    "data and analytics",
    "machine learning",
    "analytics",
    "database"
  ]
}

company.confidence

Description How confident we are that the returned company is associated with requested IP.
Data Type Enum (String)

Field Details

Will be one of the following options: very high, high, moderate, low, very low.

Our company matches are created with observed data along with registered ASN blocks. For matches we make with observed data, the confidence value is our scoring for how much and how often we have seen a company associated with an IP address.

Example

"confidence": "very high"

company.id

Description The [PDL ID](https://docs.peopledatalabs.com/docs/company-schema#id) of the company associated with the IP address
Data Type String

Field Details

See company.id for more information about how we handle company IDs.

Example

"id": "tnHcNHbCv8MKeLh92946LAkX6PKg"

company.website

Description The [primary website](https://docs.peopledatalabs.com/docs/company-schema#website) of the company associated with the IP address.
Data Type String

Field Details

See company.website for more information about how we handle company websites.

Example

"website": "peopledatalabs.com"

company.name

Description The [name](https://docs.peopledatalabs.com/docs/company-schema#name) of the company associated with the IP address.
Data Type String

Field Details

See company.name for more information about how we handle company names.

Example

"name": "people data labs"

company.display_name

Description The [display_name](https://docs.peopledatalabs.com/docs/company-schema#display_name) of the company associated with the IP address.
Data Type String

Field Details

See company.display_name for more information about how we handle company names.

Example

"display_name": "People Data Labs"

company.location

Description The [location](https://docs.peopledatalabs.com/docs/company-schema#location) of the company's primary HQ associated with the IP address
Data Type Object

Field Details

The location object will contain our common location fields:

FieldData TypeDescription
nameStringOur cleaned values for locations in the format locality, region, country.
localityString
regionString
metroEnum (String)US ONLY. These are generated based on the census-designated MSAs and maps. Will be one of our Canonical Metros.
countryEnum (String)Standardized format for country. Will be one of our Canonical Countries.
continentEnum (String)Standardized format for continent. Will be one of our Canonical Continents.
street_addressString
address_line_2String
postal_codeString
geoStringCity-center geo code of a locality, in the format latitude, longitude.

Example

"location": {
  "name": "san francisco, california, united states",
  "locality": "san francisco",
  "region": "california",
  "metro": "san francisco, california",
  "country": "united states",
  "continent": "north america",
  "street_address": "455 market street",
  "address_line_2": "suite 1670",
  "postal_code": "94105",
  "geo": "37.77,-122.41"	
},

company.location.name

Description Our cleaned values for locations in the format locality, region, country.
Data Type String

Example

"name": "san francisco, california, united states"

company.location.locality

Description The locality of the company HQ
Data Type String

Example

"locality": "san francisco"

company.location.region

Description The region of the company HQ
Data Type String

Example

"region": "california"

company.location.metro

Description US ONLY. These are generated based on the census-designated MSAs and maps. Will be one of our [Canonical Metros](https://docs.peopledatalabs.com/docs/location-metros).
Data Type Enum (String)

Example

"metro": "san francisco, california"

company.location.country

Description Standardized format for country. Will be one of our [Canonical Countries](https://docs.peopledatalabs.com/docs/location-countries).
Data Type Enum (String)

Example

"country": "united states"

company.location.continent

Description Standardized format for continent. Will be one of our [Canonical Continents](https://docs.peopledatalabs.com/docs/location-continents).
Data Type Enum (String)

Example

"continent": "north america"

company.location.street_address

Description The street address of the company HQ
Data Type String

Example

"street_address": "455 market street"

company.location.address_line_2

Description The company HQ’s street address line 2
Data Type String

Example

"address_line_2": "suite 1670"

company.location.postal_code

Description The postal code of the company HQ
Data Type String

Example

"postal_code": "94105"

company.location.geo

Description City-center geo code of a locality, in the format latitude, longitude.
Data Type String

Example

"geo": "37.77,-122.41"

company.size

Description The self-reported [size range](https://docs.peopledatalabs.com/docs/company-sizes) of the company associated with the IP address.
Data Type Enum (String)

Field Details

See company.size for more information about how we handle company size ranges.

Example

"size": "51-200"

company.industry

Description The self-reported [industry](https://docs.peopledatalabs.com/docs/industries) of the company associated with the IP address.
Data Type Enum (String)

Field Details

See company.industry for more information about how we handle company industries.

Example

"industry": "computer software"

company.inferred_revenue

Description The [estimated annual revenue](https://docs.peopledatalabs.com/docs/inferred-revenue-ranges) (in USD) of the company associated with the IP address.
Data Type Enum (String)

Field Details

See company.inferred_revenue for more information about how we handle company revenues.

Example

"inferred_revenue": "$10M-$25M"

company.employee_count

Description The current [number of employees](https://docs.peopledatalabs.com/docs/company-schema#employee_count) working at the company associated with the IP address.
Data Type Integer (> 0)

Field Details

See company.employee_count for more information about how we handle company employee counts.

Example

"employee_count": 116

company.tags

Description [Tags](https://docs.peopledatalabs.com/docs/company-schema#tags) associated with the company associated with the IP address.
Data Type Array [String]

Field Details

See company.tags for more information about how we handle company tags.

Example

"tags": [
  "b2b data",
  "people data",
  "data science",
  "data",
  "daas",
  "artificial intelligence",
  "data and analytics",
  "machine learning",
  "analytics",
  "database"
]

person

Description Information related to the person associated with the IP address
Data Type Object

Field Details

We offer several person-related fields within our IP records to understand the associated persona behind the IP. These fields are largely limited to job title information.

Example

"person": {
  "confidence": "very high",
  "job_title_sub_role": "product",
  "job_title_role": "operations",
  "job_title_levels": [
    "cxo"
  ]
}

person.confidence

Description How confident we are that the returned person is associated with requested IP.
Data Type Enum (String)

Field Details

Will be one of the following options: very high, high, moderate, low, very low.

Example

"confidence": "very high"

person.job_title_sub_role

Description The derived subrole of the person's current job title.
Data Type Enum (String)

Field Details

The value will be one of our Canonical Job Sub Roles. Each subrole maps to a role. See https://docs.peopledatalabs.com/docs/title-subroles-to-roles for a complete mapping list.

Example

"job_title_sub_role": "product",

person.job_title_role

Description The derived role of the person's current job title.
Data Type Enum (String)

Field Details

The value will be one of our Canonical Job Roles.

Example

"job_title_role": "operations"

person.levels

Description The derived level(s) of the person's current job title
Data Type Array [Enum (String)]

Field Details

Each level in the list will be one of our Canonical Job Title Levels.

Note: The cxo level is a catch-all for "Chief __ Officer" roles, so a CEO, CIO, CTO, etc. will all have job_title_levels: ["cxo"].

Example

"job_title_levels": [
  "cxo"
]

Updated 12 days ago