Person API Overview

Use the person method with an email parameter to lookup information about a specific person by email. You can also query by phone, twitter, or emailMD5 to search for a specific individual. You must also include the apiKey parameter in the query. This endpoint supports GET requests only.

Getting Started Resources

As you get started implementing the Person API, there are a few resources that can help you out. Below we’ve listed a few libraries and services.

Libraries

Other Resources

Lookup by Email

Use the person method to request more information about a specific person by email.

Requests

JSON

GET https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&apiKey=xxxx

XML

GET https://api.fullcontact.com/v2/person.xml?email=bart@fullcontact.com&apiKey=xxxx

HTML

GET https://api.fullcontact.com/v2/person.html?email=bart@fullcontact.com&apiKey=xxxx

Parameters

apiKey

This API key is assigned to you by FullContact. It is used to identify and authorize your request. Your API key should be kept private, and should never be displayed publicly.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&apiKey=xxxx

email

The email address of the person being looked up.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&apiKey=xxxx

emailMD5 (optional)

emailMD5 is an optional parameter that can be used in the place of the email parameter, allowing you to query by an MD5-hashed email address. Match rates for emailMD5 lookups will be slightly lower than those returned via the standard email parameter.

Note: Both the email and MD5 must be lower-case.

https://api.fullcontact.com/v2/person.json?emailMD5=a4cb1b07d68a3436a190e1559586ae3c&apiKey=xxxx

queue (optional)

Using this parameter notifies FullContact that the email address in question will be called later. It allows the API to make sure it has indexed the email address prior to the application needing it. When using this parameter, it will always return a response code of 202.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&queue=1&apiKey=xxxx

callback (optional)

If specified, the response will be wrapped as JSONP in a function call. For example, by specifying callback=myCallback the resulting JSON will be:

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&callback=myCallback&apiKey=xxxx

Callback Example

myCallback ({
    ...response...
})

css (optional)

The css parameter can be used to customize the look of person.html.

HTML Only

https://api.fullcontact.com/v2/person.html?email=bart@fullcontact.com&apiKey=xxxx&css=http://url_to_your_stylesheet

Download the person.html stylesheet template. This includes the default stylesheet used by FullContact, a sample Person html file and a template stylesheet for your custom styles.

style (optional)

The style parameter can be used to control the document structure returned. The default value, list, indicates that collections such as photos or socialProfiles should be grouped as arrays. An alternate value of dictionary is currently supported, which restructures collections as dictionaries. The dictionary keys in this case will be the value of the "typeId" present in the nested structure. For example, by specifying style=dictionary the resulting JSON will be:

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&style=dictionary&apiKey=xxxx

Example Dictionary Response

{
    "status": 200,
    "likelihood": 0.9,
    "requestId": "773e6782-62bb-4fc6-9f38-28ea0b5db261",
    "photos": {
        "twitter": [
            {
                "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381",
                "typeName": "Twitter",
                "isPrimary": false
            }
        ],
        "quora": [
            {
                "url": "https://d2ojpxxtu63wzl.cloudfront.net/image/8aeb64288905cbc9e73678eab24032d4_260589322c246c2e8aef934f234b4fc0c33a437e247dc80f6f9b909d2a2ba990",
                "typeName": "Quora"
            }
        ],
        "foursquare": [
            {
                "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d",
                "typeName": "Foursquare",
                "isPrimary": false
            }
        ],
        "googleplus": [
            {
                "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d",
                "typeName": "Google Plus",
                "isPrimary": false
            }
        ]
    },
    "contactInfo": {
        "familyName": "Lorang",
        "givenName": "Bart",
        "fullName": "Bart Lorang",
        "websites": [
            {
                "url": "https://fullcontact.com"
            },
            {
                "url": "http://www.flickr.com/people/39267654@N00/"
            },
            {
                "url": "http://picasaweb.google.com/lorangb"
            }
        ],
        "chats": {
            "gtalk": [
                {
                    "handle": "lorangb@gmail.com"
                }
            ],
            "skype": [
                {
                    "handle": "bart.lorang"
                }
            ]
        }
    },
    "organizations": [
        {
            "isPrimary" : true,
            "name" : "FullContact",
            "startDate" : "2010-01",
            "title" : "Co-Founder & CEO",
            "current" : true
        }, {
            "isPrimary" : false,
            "name" : "Dimension Technology Solutions",
            "startDate" : "2009-06",
            "endDate" : "2009-12",
            "title" : "Owner",
            "current" : false
        }, {
            "isPrimary" : false,
            "name" : "Dimension Technology Solutions",
            "startDate" : "2002-06",
            "endDate" : "2006-06",
            "title" : "Chief Technology Officer",
            "current" : false
        }, {
            "isPrimary" : false,
            "name" : "Dimension Technology Solutions",
            "startDate" : "1996-06",
            "endDate" : "2002-06",
            "title" : "Partner / Development Manager",
            "current" : false
        }, {
            "isPrimary" : false,
            "name" : "Dimension Technology Solutions",
            "startDate" : "2006-06",
            "endDate" : "2009-06",
            "title" : "President",
            "current" : false
        }
    ],
    "demographics": {
        "locationGeneral": "Boulder, Colorado",
        "locationDeduced" : {
            "normalizedLocation" : "Boulder, Colorado",
            "deducedLocation" : "Boulder, Colorado, United States",
            "city" : {
                "deduced" : false,
                "name" : "Boulder"
            },
            "state" : {
                "deduced" : false,
                "name" : "Colorado",
                "code" : "CO"
            },
            "country" : {
                "deduced" : true,
                "name" : "United States",
                "code" : "US"
            },
            "continent" : {
                "deduced" : true,
                "name" : "North America"
            },
            "county" : {
                "deduced" : true,
                "name" : "Boulder",
                "code" : "Boulder"
            },
            "likelihood" : 1.0
        },
        "age": "33",
        "gender": "Male",
        "ageRange": "25-34"
    },
    "socialProfiles": {
        "aboutme": [
            {
                "typeName": "About.me",
                "username": "lorangb",
                "url": "http://about.me/lorangb"
            }
        ],
        "twitter": [
            {
                "typeName": "Twitter",
                "username": "bartlorang",
                "url": "http://twitter.com/bartlorang"
            }
        ],
        "quora": [
            {
                "typeName": "Quora",
                "username": "bart-lorang",
                "url": "http://quora.com/bart-lorang"
            }
        ],
        "linkedin": [
            {
                "typeName": "LinkedIn",
                "username": "bartlorang",
                "url": "http://linkedin.com/in/bartlorang"
            }
        ],
        "klout": [
            {
                "typeName": "Klout",
                "username": "lorangb",
                "url": "http://klout.com/#/lorangb"
            }
        ],
        "youtube": [
            {
                "typeName": "YouTube",
                "username": "lorangb",
                "url": "http://youtube.com/user/lorangb"
            }
        ],
        "myspace": [
            {
                "typeName": "MySpace",
                "userid": "137200880",
                "url": "http://myspace.com/137200880"
            }
        ],
        "foursquare": [
            {
                "typeName": "FourSquare",
                "username": "bartlorang",
                "url": "http://foursquare.com/bartlorang"
            }
        ],
        "googleprofile": [
            {
                "typeName": "Google Profile",
                "userid": "114426306375480734745",
                "url": "http://profiles.google.com/114426306375480734745"
            }
        ],
        "googleplus": [
            {
                "typeName": "Google Plus",
                "userid": "114426306375480734745",
                "url": "http://plus.google.com/114426306375480734745"
            }
        ]
    }
}

prettyPrint (optional)

The prettyPrint parameter can be used to disable prettyprint formatting on the API response.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&apiKey=xxxx&prettyPrint=false

webhooksUrl (required for webhooks only)

View Webhook flow diagram

For the webhookUrl parameter, enter the callback url you'd like the data to be posted back to (ie. https://mydomain.com/callback/listener). The webhookUrl must be URL encoded

When you include the webhookUrl parameter in your API request, an HTTP POST request will be triggered to the URL you've specified. The payload of the response POSTed to the webhook URL is by default formatted as a URL-encoded form with the contents of the "result" form/post parameters being a URL-encoded JSON document. This is the format regardless of whether the initial request to v2/Person was to the .json, .xml or .html version of the person endpoint.

When testing webhooks during development, we recommend intercepting the webhook POST requests locally, or using a web-based webhook testing service likeRequestb.in. Requestb.in lets you debug webhooks by capturing and logging the asynchronous requests made when events happen. Create a Requestb.in URL and insert the URL provided into the webhookUrl parameter of your API request. All messages POSTed to the Requestb.in URL will be available almost immediately after you initiate a webhook-based request.

NOTE: We will make 3 attempts to deliver the payload, waiting a minimum of 2 seconds between each attempt. If a 200 response is not received within 3 attempts, the request will be dropped.

BLACKLISTING: If FullContact can’t deliver at least 10 consecutive, successful messages to a specified URI over a 5 minute period, we will temporarily impose a 5 minute blacklisting of the URI. After the 5 minutes has elapsed, the blacklist will be automatically removed and FullContact will resume webhook delivery attempts.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&webhookUrl=myWebhookUrl&apiKey=xxxx

Example Encoded Webhook URL

http%3A%2F%2Fmydomain.com%2Fwebhook

webhookId (optional)

You can enter anything you want here, we will just pass it back in the response. This allows you to track the webhook if you wish.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&webhookUrl=myWebhookUrl&webhookId=myId&apiKey=xxxx

Webhook Example Response (URL-Encoded Form)

&webhookId=myID&result=%22status%22%3A200%2C%22contactInfo%22%3A%7B%22familyName%22%3A%22Lorang%22
%2C%22fullName%22%3A%22Bart+Lorang%22%2C%22givenName%22%3A%22Bart%22

  /*** results truncated ***/
}

webhookBody (optional)

You can specify that the payload of the webhook response be retuned as a JSON document instead of a URL-encoded form using the webhookBody=json query parameter. A JSON document will be the format regardless of whether the initial request to v2/Person was to the .json, .xml or .html version of the person endpoint.

https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com&webhookUrl=myWebhookUrl&webhookBody=json&apiKey=xxxx

Webhook Example Response (As JSON Document)

{
    "result": {
        "status": 200,
        "contactInfo": {
            "familyName": "Lorang",
            "givenName": "Bart",
            "fullName": "Bart Lorang"
        }
            /*** results truncated ***/
    },
    "webhookId": "myId"
}

Example Responses

The API responds with JSON, HTML, or XML.

JSON

{
  "status": 200,
  "likelihood": 0.9,
  "requestId": "773e6782-62bb-4fc6-9f38-28ea0b5db261",
  "contactInfo": {
    "familyName": "Lorang",
    "givenName": "Bart",
    "fullName": "Bart Lorang",
    "websites": 
    [
      {
        "url": "https://www.fullcontact.com"
      }
    ]
  },
  "demographics": {
    "locationGeneral": "Boulder, Colorado",
    "locationDeduced" : {
      "normalizedLocation" : "Boulder, Colorado",
      "deducedLocation" : "Boulder, Colorado, United States",
      "city" : {
        "deduced" : false,
        "name" : "Boulder"
      },
      "state" : {
        "deduced" : false,
        "name" : "Colorado",
        "code" : "CO"
      },
      "country" : {
        "deduced" : true,
        "name" : "United States",
        "code" : "US"
      },
      "continent" : {
        "deduced" : true,
        "name" : "North America"
      },
      "county" : {
        "deduced" : true,
        "name" : "Boulder",
        "code" : "Boulder"
      },
      "likelihood" : 1.0
    },
    "age": "33",
    "gender": "Male",
    "ageRange": "25-34"
  },
  "socialProfiles": 
  [
    {
      "typeId": "twitter",
      "typeName": "Twitter",
      "url": "http://www.twitter.com/bartlorang",
      "id": 5998422,
      "username": "lorangb",
      "bio": "CEO & Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.",
      "followers": 631,
      "following": 485,
      "rss": "http://twitter.com/statuses/user_timeline/bartlorang.rss"
    },
    {
      "typeId": "linkedin",
      "typeName": "Linkedin",
      "url": "http://www.linkedin.com/in/bartlorang",
      "id": "6xtewkyGle",
      "username": "bartlorang",
      "bio": "Co-Founder & CEO at FullContact",
      "following": 1071,
      "followers": 1071
    },
    {
      "url": "http://about.me/lorangb",
      "username": "lorangb",
      "typeId": "aboutme",
      "typeName": "About Me"
    },
    {
      "url": "http://profiles.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleprofile",
      "typeName": "Google Profile"
    },
    {
      "url": "http://www.quora.com/bart-lorang",
      "username": "bart-lorang",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "http://foursquare.com/lorangb",
      "username": "lorangb",
      "typeId": "foursquare",
      "typeName": "Foursquare",
      "id": "10245647"
    },
    {
      "url": "http://youtube.com/user/lorangb",
      "username": "lorangb",
      "rss": "http://youtube.com/rss/user/lorangb/videos.rss",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "http://picasaweb.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "rss": "http://picasaweb.google.com/data/feed/base/user/lorangb",
      "typeId": "picasa",
      "typeName": "Picasa"
    },
    {
      "url": "http://plancast.com/lorangb",
      "id": "1634762",
      "username": "lorangb",
      "typeId": "plancast",
      "typeName": "Plancast"
    },
    {
      "url": "https://plus.google.com/114426306375480734745",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    },
    {
      "typeId": "klout",
      "typeName": "Klout",
      "url": "http://www.klout.com/lorangb",
      "username": "lorangb"
    },
    {
      "url": "http://www.flickr.com/photos/39267654@N00/",
      "id": "39267654@N00",
      "rss": "http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00",
      "typeId": "flickr",
      "typeName": "Flickr"
    }
  ],
  "organizations": [
    {
        "isPrimary": true,
        "name": "FullContact",
        "startDate": "2010-01",
        "title": "Co-Founder & CEO",
        "current": true
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2009-06",
        "endDate": "2009-12",
        "title": "Owner",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2002-06",
        "endDate": "2006-06",
        "title": "Chief Technology Officer",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "1996-06",
        "endDate": "2002-06",
        "title": "Partner / Development Manager",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2006-06",
        "endDate": "2009-06",
        "title": "President",
        "current": false
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": "entrepreneurship",
        "provider": "klout"
      },
      {
        "value": "angel investing",
        "provider": "klout"
      },
      {
        "value": "techstars",
        "provider": "klout"
      },
      {
        "value": "boulder",
        "provider": "klout"
      },
      {
        "value": "tequila",
        "provider": "klout"
      }
    ],
    "scores": 
    [
      {
        "provider": "klout",
        "type": "general",
        "value": 61
      }
    ]
  },
  "photos": 
  [
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381",
      "typeId": "twitter",
      "typeName": "Twitter"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9",
      "typeId": "linkedin",
      "typeName": "Linkedin"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d",
      "typeId": "foursquare",
      "typeName": "Foursquare"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    }
  ],
 }

HTML

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title>Bart Lorang</title>
</head>

<body>
  <div id="cotactInfo">
    <table style=
    "font-family:Arial,Helvetica; font-size: 13px;padding:10px; border:0px; -moz-border-radius:4px;-webkit-border-radius:4px; border-radius:4px;">
    <tr>
        <td class="contactPhoto" valign="top" style=
        "vertical-align: top; text-align: left;">
          <div style=
          "margin-right:10px; border:3px solid #dddddd; min-height:77px; min-width:77px;">
          <img style="height:80px; width:80px;padding:0px;margin:0px" width="80" height=
          "80" src=
          "https://d2ojpxxtu63wzl.cloudfront.net/static/cf9e151530e386f6d86450206fd1345a_ea1f4c9ffb6856596b3df04b6b797de722f79a9781ba29bf172c52136f576557"
          alt="" /></div>
        </td>
        <td valign="top" style="vertical-align: top; text-align: left;">
          <table>
            <tr>
              <td id="name" style=
              "vertical-align: top; text-align: left; padding-bottom:5px; font-weight:bold; font-size:18px;">
              Bart Lorang</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "font-weight:bold;vertical-align: top; text-align: left;padding-bottom:1px;font-size: 18px;">
              Chief Executive Officer and Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="age" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Male, 33 years
              old</td>
              <td></td>
            </tr>
            <tr>
              <td id="location" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Boulder,
              Colorado, United States</td>
              <td></td>
            </tr>
            <tr>
              <td id="socialProfiles" style="vertical-align: top; text-align: left;">
              <a target="_blank" href="http://www.twitter.com/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/twitter_16.png" /></a>
              <a target="_blank" href="http://www.linkedin.com/in/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/linkedin_16.png" /></a>
              <a target="_blank" href="http://about.me/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/aboutme_16.png" /></a>
              <a target="_blank" href="http://profiles.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleprofile_16.png" />
              </a> <a target="_blank" href="http://www.quora.com/bart-lorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/quora_16.png" /></a>
              <a target="_blank" href="http://foursquare.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/foursquare_16.png" />
              </a> <a target="_blank" href="http://youtube.com/user/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/youtube_16.png" /></a>
              <a target="_blank" href="http://picasaweb.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/picasa_16.png" /></a>
              <a target="_blank" href="http://plancast.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/plancast_16.png" /></a>
              <a target="_blank" href=
              "https://plus.google.com/114426306375480734745"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleplus_16.png" />
              </a> <a target="_blank" href="http://www.klout.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/klout_16.png" /></a>
              <a target="_blank" href="http://www.myspace.com/137200880"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/myspace_16.png" /></a>
              <a target="_blank" href=
              "http://www.flickr.com/photos/39267654@N00/"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/flickr_16.png" /></a></td>
              <td></td>
            </tr>
            <tr>
              <td>Other Organizations:</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">CEO &amp;
              Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Techstars</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, Rainmaker Technologies</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
          </table>
        </td>
      </tr>
    </table>
    <table style="width: 100%" width="100%">
      <tr>
        <td style="text-align:right"><span style=
        "font-size:9px;margin-right:50px;">Provided By</span><br />
        <a href="https://www.fullcontact.com/"><img style="border:none;" src=
        "http://api.fullcontact.com/images/fullcontactlogo_sm.png" alt=
        "Provided by FullContact" /></a></td>
      </tr>
    </table>
  </div>
</body>
</html>

XML

<?xml version="1.0" encoding="UTF-8" ?>
<person>
  <status>200</status>
  <requestId>773e6782-62bb-4fc6-9f38-28ea0b5db261</requestId>
  <likelihood>0.9</likelihood>  
  <contactInfo>
    <familyName>Lorang</familyName>
    <givenName>Bart</givenName>
    <fullName>Bart Lorang</fullName>
    <websites>
      <website>
        <url>https://www.fullcontact.com</url>
      </website>
    </websites>
  </contactInfo>
  <photos>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381</url>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9</url>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
    </photo>
    <photo>
 <url>https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d</url>
      <type>googleplus</type>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a</url>
      <type>quora</type>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36</url>
      <type>youtube</type>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d</url>
      <type>foursquare</type>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
    </photo>
  </photos>
  <demographics>
    <locationGeneral>Boulder, Colorado</locationGeneral>
    <locationDeduced>
      <normalizedLocation>Boulder, Colorado</normalizedLocation>
      <deducedLocation>Boulder, Colorado, United States</deducedLocation>
      <city>
        <deduced>false</deduced>
        <name>Boulder</name>
      </city>
      <state>
        <deduced>false</deduced>
        <name>Colorado</name>
        <code>CO</code>
      </state>
      <country>
        <deduced>true</deduced>
        <name>United States</name>
        <code>US</code>
      </country>
      <continent>
        <deduced>true</deduced>
        <name>North America</name>
      </continent>
      <county>
        <deduced>true</deduced>
        <name>Boulder</name>
        <code>Boulder</code>
      </county>
      <likelihood>1.0</likelihood>
    </locationDeduced>
    <age>33</age>
    <gender>Male</gender>
    <ageRange>25-34</ageRange>
  </demographics>
  <socialProfiles>
    <socialProfile>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
      <url>http://www.twitter.com/bartlorang</url>
      <id>5998422</id>
      <username>lorangb</username>
      <bio>CEO &amp; Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.</bio>
      <followers>637</followers>
      <following>485</following>
      <rss>http://twitter.com/statuses/user_timeline/bartlorang.rss</rss>
    </socialProfile>
    <socialProfile>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
      <url>http://www.linkedin.com/in/bartlorang</url>
      <id>6xtewkyGle</id>
      <username>bartlorang</username>
      <bio>Co-Founder &amp; CEO at FullContact</bio>
      <following>1071</following>
      <followers>1071</followers>
    </socialProfile>
    <socialProfile>
      <url>http://about.me/lorangb</url>
      <type>aboutme</type>
      <username>lorangb</username>
      <typeId>aboutme</typeId>
      <typeName>About Me</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://profiles.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>googleprofile</type>
      <username>lorangb</username>
      <typeId>googleprofile</typeId>
      <typeName>Google Profile</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.quora.com/bart-lorang</url>
      <type>quora</type>
      <username>bart-lorang</username>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://foursquare.com/lorangb</url>
      <type>foursquare</type>
      <username>lorangb</username>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
      <id>10245647</id>
    </socialProfile>
    <socialProfile>
      <url>http://youtube.com/user/lorangb</url>
      <type>youtube</type>
      <username>lorangb</username>
      <rss>http://youtube.com/rss/user/lorangb/videos.rss</rss>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://picasaweb.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>picasa</type>
      <username>lorangb</username>
   <rss>http://picasaweb.google.com/data/feed/base/user/lorangb?kind=album&amp;alt=rss&amp;hl=en_US&amp;access=public</rss>
      <typeId>picasa</typeId>
      <typeName>Picasa</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://plancast.com/lorangb</url>
      <id>1634762</id>
      <type>plancast</type>
      <username>lorangb</username>
      <typeId>plancast</typeId>
      <typeName>Plancast</typeName>
    </socialProfile>
    <socialProfile>
      <url>https://plus.google.com/114426306375480734745</url>
      <id>114426306375480734745</id>
      <type>googleplus</type>
      <username>lorangb</username>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </socialProfile>
    <socialProfile>
      <type>klout</type>
      <typeId>klout</typeId>
      <typeName>Klout</typeName>
      <url>http://www.klout.com/lorangb</url>
      <username>lorangb</username>
    </socialProfile>
    <socialProfile>
      <url>http://www.myspace.com/137200880</url>
      <type>myspace</type>
      <typeId>myspace</typeId>
      <typeName>Myspace</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.flickr.com/photos/39267654@N00/</url>
      <id>39267654@N00</id>
      <type>flickr</type>
      <rss>http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00&amp;lang=en-us&amp;format=rss_200</rss>
      <typeId>flickr</typeId>
      <typeName>Flickr</typeName>
    </socialProfile>
  </socialProfiles>
  <organizations>
    <organization>
      <isPrimary>true</isPrimary>
      <name>FullContact</name>
      <title>Co-founder &amp; CEO</title>
      <startDate>2010-01</startDate>
      <current>true</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2009-06</startDate>
      <endDate>2009-12</endDate>
      <title>Owner</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2002-06</startDate>
      <endDate>2006-06</endDate>
      <title>Chief Technology Officer</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>1996-06</startDate>
      <endDate>2002-06</endDate>
      <title>Partner/Development Manager</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2006-06</startDate>
      <endDate>2009-06</endDate>
      <title>President</title>      
      <current>false</current>
    </organization>
  </organizations>
  <digitalFootprint>
    <topics>
      <topic>
        <value>entrepreneurship</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>angel investing</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>techstars</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>boulder</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>tequila</value>
        <provider>klout</provider>
      </topic>
    </topics>
    <scores>
      <score>
        <provider>klout</provider>
        <type>general</type>
        <value>61</value>
      <score>
    </scores>
  </digitalFootprint>
</person>

Response Schema

The following is a description of the Person API response schema. It includes every possible field, collection, and value you can expect to receive. Note that certain fields and collections will only appear in the response when the data is available.

{
  "status": {"type":"number"},
  "requestId": {"type":"string"},
  "likelihood": {"type":"number"},
  "contactInfo": {
    "familyName": {"type":"string"},
    "givenName": {"type":"string"},
    "fullName": {"type":"string"},
    "middleNames": 
    [
      {"type":"string"}
    ],
    "websites": 
    [
      {
        "url": {"type":"string"}
      }
    ],
    "chats": 
    [
      {
        "handle": {"type":"string"},
        "client": {"type":"string"}
      }
    ]
  },
  "demographics": {
    "locationGeneral": {"type":"string"},
    "locationDeduced": {
      "normalizedLocation": {"type":"string"},
      "deducedLocation" : {"type":"string"},
      "city" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "state" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "country" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "continent" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "county" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "likelihood" : {"type":"number"}
    },
    "age": {"type":"string"},
    "gender": {"type":"string"},
    "ageRange": {"type":"string"}
  },
  "photos": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "url": {"type":"string"},
      "isPrimary": {"type":"boolean"}
    }
  ],
  "socialProfiles": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "id": {"type":"string"},
      "username": {"type":"string"},
      "url": {"type":"string"},
      "bio": {"type":"string"},
      "rss": {"type":"string"},
      "following": {"type":"number"},
      "followers": {"type":"number"}
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": {"type":"string"},
        "provider": {"type":"string"}
      }
    ],
    "scores": 
    [
      {
        "provider": {"type":"string"},
        "type": {"type":"string"},
        "value": {"type":"number"}
      }
    ]
  },
  "organizations": 
  [
    {
      "title": {"type":"string"},
      "name": {"type":"string"},
      "startDate": {"type":"string"},   // formatted as "YYYY-MM"
      "endDate":  {"type":"string"},    // formatted as "YYYY-MM"
      "isPrimary": {"type":"boolean"}
      "current": {"type":"boolean"}
    }
  ]
}

Lookup by Phone

Use the person method to request more information about a specific person by phone.

Requests

JSON

https://api.fullcontact.com/v2/person.json?phone=+13037170414&apiKey=xxxx

XML

https://api.fullcontact.com/v2/person.xml?phone=+13037170414&apiKey=xxxx

HTML

https://api.fullcontact.com/v2/person.html?phone=+13037170414&apiKey=xxxx

Parameters

apiKey

This API key is assigned to you by FullContact. It is used to identify and authorize your request. Your API key should be kept private, and should never be displayed publicly.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&apiKey=xxxx

phone (highly experimental)

The phone number of the person being looked up.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&apiKey=xxxx

queue (optional)

Using this parameter notifies FullContact that the email address in question will be called later. It allows the API to make sure it has indexed the email address prior to the application needing it. When using this parameter, it will always return a response code of 202.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&queue=1&apiKey=xxxx

countryCode (optional)

This parameter must be passed when using non US/Canada based numbers. Use the ISO-3166 two-digit country code (Great Britain = GB). If not entered it defaults to US.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&countryCode=US&apiKey=xxxx

callback (optional)

If specified, the response will be wrapped as JSONP in a function call. For example, by specifying callback=myCallback the resulting JSON will be:

https://api.fullcontact.com/v2/person.json?phone=+13037170414&callback=myCallback&apiKey=xxxx

Callback Example

myCallback ({
    ...response...
})

css (optional)

The css parameter can be used to customize the look of person.html.

HTML Only

https://api.fullcontact.com/v2/person.html?phone=+13037170414&apiKey=xxxx&css=http://url_to_your_stylesheet

Download the person.html stylesheet template. This includes the default stylesheet used by FullContact, a sample Person html file and a template stylesheet for your custom styles.

prettyPrint (optional)

The prettyPrint parameter can be used to disable prettyprint formatting on the API response.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&apiKey=xxxx&prettyPrint=false

webhooksUrl (required for webhooks only)

View Webhook flow diagram

For the webhookUrl parameter, enter the callback url you'd like the data to be posted back to (ie. https://mydomain.com/callback/listener). The webhookUrl must be URL encoded

When you include the webhookUrl parameter in your API request, an HTTP POST request will be triggered to the URL you've specified. The payload of the response POSTed to the webhook URL is by default formatted as a URL-encoded form with the contents of the "result" form/post parameters being a URL-encoded JSON document. This is the format regardless of whether the initial request to v2/Person was to the .json, .xml or .html version of the person endpoint.

When testing webhooks during development, we recommend intercepting the webhook POST requests locally, or using a web-based webhook testing service likeRequestb.in. Requestb.in lets you debug webhooks by capturing and logging the asynchronous requests made when events happen. Create a Requestb.in URL and insert the URL provided into the webhookUrl parameter of your API request. All messages POSTed to the Requestb.in URL will be available almost immediately after you initiate a webhook-based request.

NOTE: We will make 3 attempts to deliver the payload, waiting a minimum of 2 seconds between each attempt. If a 200 response is not received within 3 attempts, the request will be dropped.

BLACKLISTING: If FullContact can’t deliver at least 10 consecutive, successful messages to a specified URI over a 5 minute period, we will temporarily impose a 5 minute blacklisting of the URI. After the 5 minutes has elapsed, the blacklist will be automatically removed and FullContact will resume webhook delivery attempts.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&webhookUrl=myWebhookUrl&apiKey=xxxx

Example Encoded Webhook URL

http%3A%2F%2Fmydomain.com%2Fwebhook

webhookId (optional)

You can enter anything you want here, we will just pass it back in the response. This allows you to track the webhook if you wish.

https://api.fullcontact.com/v2/person.json?phone=+13037170414&webhookUrl=myWebhookUrl&webhookId=myId&apiKey=xxxx

Webhook Example Response

result = {
    "status": 200,
    "contactInfo": {
        "familyName": "Lorang",
        "givenName": "Bart",
        "fullName": "Bart Lorang",

        *** results truncated ***
}

webhookId =  "myId"

Example Responses

The API responds with JSON, HTML, or XML.

JSON

{
  "status": 200,
  "likelihood": 0.9,
  "requestId": "773e6782-62bb-4fc6-9f38-28ea0b5db261",  
  "contactInfo": {
    "familyName": "Lorang",
    "givenName": "Bart",
    "fullName": "Bart Lorang",
    "websites": 
    [
      {
        "url": "https://www.fullcontact.com"
      }
    ]
  },
  "demographics": {
    "locationGeneral": "Boulder, Colorado",
    "locationDeduced" : {
      "normalizedLocation" : "Boulder, Colorado",
      "deducedLocation" : "Boulder, Colorado, United States",
      "city" : {
        "deduced" : false,
        "name" : "Boulder"
      },
      "state" : {
        "deduced" : false,
        "name" : "Colorado",
        "code" : "CO"
      },
      "country" : {
        "deduced" : true,
        "name" : "United States",
        "code" : "US"
      },
      "continent" : {
        "deduced" : true,
        "name" : "North America"
      },
      "county" : {
        "deduced" : true,
        "name" : "Boulder",
        "code" : "Boulder"
      },
      "likelihood" : 1.0
    },
    "age": "33",
    "gender": "Male",
    "ageRange": "25-34"
  },
  "socialProfiles": 
  [
    {
      "typeId": "twitter",
      "typeName": "Twitter",
      "url": "http://www.twitter.com/bartlorang",
      "id": 5998422,
      "username": "lorangb",
      "bio": "CEO & Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.",
      "followers": 631,
      "following": 485,
      "rss": "http://twitter.com/statuses/user_timeline/bartlorang.rss"
    },
    {
      "typeId": "linkedin",
      "typeName": "Linkedin",
      "url": "http://www.linkedin.com/in/bartlorang",
      "id": "6xtewkyGle",
      "username": "bartlorang",
      "bio": "Co-Founder & CEO at FullContact",
      "following": 1071,
      "followers": 1071
    },
    {
      "url": "http://about.me/lorangb",
      "username": "lorangb",
      "typeId": "aboutme",
      "typeName": "About Me"
    },
    {
      "url": "http://profiles.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleprofile",
      "typeName": "Google Profile"
    },
    {
      "url": "http://www.quora.com/bart-lorang",
      "username": "bart-lorang",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "http://foursquare.com/lorangb",
      "username": "lorangb",
      "typeId": "foursquare",
      "typeName": "Foursquare",
      "id": "10245647"
    },
    {
      "url": "http://youtube.com/user/lorangb",
      "username": "lorangb",
      "rss": "http://youtube.com/rss/user/lorangb/videos.rss",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "http://picasaweb.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "rss": "http://picasaweb.google.com/data/feed/base/user/lorangb",
      "typeId": "picasa",
      "typeName": "Picasa"
    },
    {
      "url": "http://plancast.com/lorangb",
      "id": "1634762",
      "username": "lorangb",
      "typeId": "plancast",
      "typeName": "Plancast"
    },
    {
      "url": "https://plus.google.com/114426306375480734745",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    },
    {
      "typeId": "klout",
      "typeName": "Klout",
      "url": "http://www.klout.com/lorangb",
      "username": "lorangb"
    },
    {
      "url": "http://www.flickr.com/photos/39267654@N00/",
      "id": "39267654@N00",
      "rss": "http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00",
      "typeId": "flickr",
      "typeName": "Flickr"
    }
  ],
 "organizations": [
    {
        "isPrimary": true,
        "name": "FullContact",
        "startDate": "2010-01",
        "title": "Co-Founder & CEO",
        "current": true
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2009-06",
        "endDate": "2009-12",
        "title": "Owner",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2002-06",
        "endDate": "2006-06",
        "title": "Chief Technology Officer",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "1996-06",
        "endDate": "2002-06",
        "title": "Partner / Development Manager",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2006-06",
        "endDate": "2009-06",
        "title": "President",
        "current": false
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": "entrepreneurship",
        "provider": "klout"
      },
      {
        "value": "angel investing",
        "provider": "klout"
      },
      {
        "value": "techstars",
        "provider": "klout"
      },
      {
        "value": "boulder",
        "provider": "klout"
      },
      {
        "value": "tequila",
        "provider": "klout"
      }
    ],
    "scores": 
    [
      {
        "provider": "klout",
        "type": "general",
        "value": 61
      }
    ]
  },
  "photos": 
  [
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381",
      "typeId": "twitter",
      "typeName": "Twitter"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9",
      "typeId": "linkedin",
      "typeName": "Linkedin"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d",
      "typeId": "foursquare",
      "typeName": "Foursquare"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    }
  ]
}

HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title>Bart Lorang</title>
</head>

<body>
  <div id="cotactInfo">
    <table style=
    "font-family:Arial,Helvetica; font-size: 13px;padding:10px; border:0px; -moz-border-radius:4px;-webkit-border-radius:4px; border-radius:4px;">
    <tr>
        <td class="contactPhoto" valign="top" style=
        "vertical-align: top; text-align: left;">
          <div style=
          "margin-right:10px; border:3px solid #dddddd; min-height:77px; min-width:77px;">
          <img style="height:80px; width:80px;padding:0px;margin:0px" width="80" height=
          "80" src=
          "https://d2ojpxxtu63wzl.cloudfront.net/static/cf9e151530e386f6d86450206fd1345a_ea1f4c9ffb6856596b3df04b6b797de722f79a9781ba29bf172c52136f576557"
          alt="" /></div>
        </td>
        <td valign="top" style="vertical-align: top; text-align: left;">
          <table>
            <tr>
              <td id="name" style=
              "vertical-align: top; text-align: left; padding-bottom:5px; font-weight:bold; font-size:18px;">
              Bart Lorang</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "font-weight:bold;vertical-align: top; text-align: left;padding-bottom:1px;font-size: 18px;">
              Chief Executive Officer and Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="age" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Male, 33 years
              old</td>
              <td></td>
            </tr>
            <tr>
              <td id="location" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Boulder,
              Colorado, United States</td>
              <td></td>
            </tr>
            <tr>
              <td id="socialProfiles" style="vertical-align: top; text-align: left;">
              <a target="_blank" href="http://www.twitter.com/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/twitter_16.png" /></a>
              <a target="_blank" href="http://www.linkedin.com/in/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/linkedin_16.png" /></a>
              <a target="_blank" href="http://about.me/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/aboutme_16.png" /></a>
              <a target="_blank" href="http://profiles.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleprofile_16.png" />
              </a> <a target="_blank" href="http://www.quora.com/bart-lorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/quora_16.png" /></a>
              <a target="_blank" href="http://foursquare.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/foursquare_16.png" />
              </a> <a target="_blank" href="http://youtube.com/user/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/youtube_16.png" /></a>
              <a target="_blank" href="http://picasaweb.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/picasa_16.png" /></a>
              <a target="_blank" href="http://plancast.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/plancast_16.png" /></a>
              <a target="_blank" href=
              "https://plus.google.com/114426306375480734745"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleplus_16.png" />
              </a> <a target="_blank" href="http://www.klout.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/klout_16.png" /></a>
              <a target="_blank" href="http://www.myspace.com/137200880"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/myspace_16.png" /></a>
              <a target="_blank" href=
              "http://www.flickr.com/photos/39267654@N00/"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/flickr_16.png" /></a></td>
              <td></td>
            </tr>
            <tr>
              <td>Other Organizations:</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">CEO &amp;
              Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Techstars</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, Rainmaker Technologies</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
          </table>
        </td>
      </tr>
    </table>
    <table style="width: 100%" width="100%">
      <tr>
        <td style="text-align:right"><span style=
        "font-size:9px;margin-right:50px;">Provided By</span><br />
        <a href="https://www.fullcontact.com/"><img style="border:none;" src=
        "http://api.fullcontact.com/images/fullcontactlogo_sm.png" alt=
        "Provided by FullContact" /></a></td>
      </tr>
    </table>
  </div>
</body>
</html>

XML

<?xml version="1.0" encoding="UTF-8" ?>
<person>
  <status>200</status>
  <requestId>773e6782-62bb-4fc6-9f38-28ea0b5db261</requestId>
  <likelihood>0.9</likelihood> 
  <contactInfo>
    <familyName>Lorang</familyName>
    <givenName>Bart</givenName>
    <fullName>Bart Lorang</fullName>
    <websites>
      <website>
        <url>https://www.fullcontact.com</url>
      </website>
    </websites>
  </contactInfo>
  <photos>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381</url>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9</url>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
    </photo>
    <photo>
 <url>https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d</url>
      <type>googleplus</type>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </photo>

    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a</url>
      <type>quora</type>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36</url>
      <type>youtube</type>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d</url>
      <type>foursquare</type>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
    </photo>
  </photos>
  <demographics>
    <locationGeneral>Boulder, Colorado</locationGeneral>
    <locationDeduced>
      <normalizedLocation>Boulder, Colorado</normalizedLocation>
      <deducedLocation>Boulder, Colorado, United States</deducedLocation>
      <city>
        <deduced>false</deduced>
        <name>Boulder</name>
      </city>
      <state>
        <deduced>false</deduced>
        <name>Colorado</name>
        <code>CO</code>
      </state>
      <country>
        <deduced>true</deduced>
        <name>United States</name>
        <code>US</code>
      </country>
      <continent>
        <deduced>true</deduced>
        <name>North America</name>
      </continent>
      <county>
        <deduced>true</deduced>
        <name>Boulder</name>
        <code>Boulder</code>
      </county>
      <likelihood>1.0</likelihood>
    </locationDeduced>
    <age>33</age>
    <gender>Male</gender>
    <ageRange>25-34</ageRange>
  </demographics>
  <socialProfiles>
    <socialProfile>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
      <url>http://www.twitter.com/bartlorang</url>
      <id>5998422</id>
      <username>lorangb</username>
      <bio>CEO &amp; Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.</bio>
      <followers>637</followers>
      <following>485</following>
      <rss>http://twitter.com/statuses/user_timeline/bartlorang.rss</rss>
    </socialProfile>
    <socialProfile>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
      <url>http://www.linkedin.com/in/bartlorang</url>
      <id>6xtewkyGle</id>
      <username>bartlorang</username>
      <bio>Co-Founder &amp; CEO at FullContact</bio>
      <following>1071</following>
      <followers>1071</followers>
    </socialProfile>
    <socialProfile>
      <url>http://about.me/lorangb</url>
      <type>aboutme</type>
      <username>lorangb</username>
      <typeId>aboutme</typeId>
      <typeName>About Me</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://profiles.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>googleprofile</type>
      <username>lorangb</username>
      <typeId>googleprofile</typeId>
      <typeName>Google Profile</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.quora.com/bart-lorang</url>
      <type>quora</type>
      <username>bart-lorang</username>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://foursquare.com/lorangb</url>
      <type>foursquare</type>
      <username>lorangb</username>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
      <id>10245647</id>
    </socialProfile>
    <socialProfile>
      <url>http://youtube.com/user/lorangb</url>
      <type>youtube</type>
      <username>lorangb</username>
      <rss>http://youtube.com/rss/user/lorangb/videos.rss</rss>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://picasaweb.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>picasa</type>
      <username>lorangb</username>
   <rss>http://picasaweb.google.com/data/feed/base/user/lorangb?kind=album&amp;alt=rss&amp;hl=en_US&amp;access=public</rss>
      <typeId>picasa</typeId>
      <typeName>Picasa</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://plancast.com/lorangb</url>
      <id>1634762</id>
      <type>plancast</type>
      <username>lorangb</username>
      <typeId>plancast</typeId>
      <typeName>Plancast</typeName>
    </socialProfile>
    <socialProfile>
      <url>https://plus.google.com/114426306375480734745</url>
      <id>114426306375480734745</id>
      <type>googleplus</type>
      <username>lorangb</username>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </socialProfile>
    <socialProfile>
      <type>klout</type>
      <typeId>klout</typeId>
      <typeName>Klout</typeName>
      <url>http://www.klout.com/lorangb</url>
      <username>lorangb</username>
    </socialProfile>
    <socialProfile>
      <url>http://www.myspace.com/137200880</url>
      <type>myspace</type>
      <typeId>myspace</typeId>
      <typeName>Myspace</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.flickr.com/photos/39267654@N00/</url>
      <id>39267654@N00</id>
      <type>flickr</type>
      <rss>http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00&amp;lang=en-us&amp;format=rss_200</rss>
      <typeId>flickr</typeId>
      <typeName>Flickr</typeName>
    </socialProfile>
  </socialProfiles>
  <organizations>
    <organization>
      <isPrimary>true</isPrimary>
      <name>FullContact</name>
      <title>Co-founder &amp; CEO</title>
      <startDate>2010-01</startDate>
      <current>true</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2009-06</startDate>
      <endDate>2009-12</endDate>
      <title>Owner</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2002-06</startDate>
      <endDate>2006-06</endDate>
      <title>Chief Technology Officer</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>1996-06</startDate>
      <endDate>2002-06</endDate>
      <title>Partner/Development Manager</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2006-06</startDate>
      <endDate>2009-06</endDate>
      <title>President</title>      
      <current>false</current>
    </organization>
  </organizations>
  <digitalFootprint>
    <topics>
      <topic>
        <value>entrepreneurship</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>angel investing</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>techstars</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>boulder</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>tequila</value>
        <provider>klout</provider>
      </topic>
    </topics>
    <scores>
      <score>
        <provider>klout</provider>
        <type>general</type>
        <value>61</value>
      <score>
    </scores>
  </digitalFootprint>
</person>

Response Schema

The following is a description of the Person API response schema. It includes every possible field, collection, and value you can expect to receive. Note that certain fields and collections will only appear in the response when the data is available.

{
  "status": {"type":"number"},
  "requestId": {"type":"string"},
  "likelihood": {"type":"number"},  
  "contactInfo": {
    "familyName": {"type":"string"},
    "givenName": {"type":"string"},
    "fullName": {"type":"string"},
    "middleNames": 
    [
      {"type":"string"}
    ],
    "websites": 
    [
      {
        "url": {"type":"string"}
      }
    ],
    "chats": 
    [
      {
        "handle": {"type":"string"},
        "client": {"type":"string"}
      }
    ]
  },
  "demographics": {
    "locationGeneral": {"type":"string"},
    "locationDeduced": {
      "normalizedLocation": {"type":"string"},
      "deducedLocation" : {"type":"string"},
      "city" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "state" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "country" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "continent" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "county" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "likelihood" : {"type":"number"}
    },
    "age": {"type":"string"},
    "gender": {"type":"string"},
    "ageRange": {"type":"string"}
  },
  "photos": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "url": {"type":"string"},
      "isPrimary": {"type":"boolean"}
    }
  ],
  "socialProfiles": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "id": {"type":"string"},
      "username": {"type":"string"},
      "url": {"type":"string"},
      "bio": {"type":"string"},
      "rss": {"type":"string"},
      "following": {"type":"number"},
      "followers": {"type":"number"}
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": {"type":"string"},
        "provider": {"type":"string"}
      }
    ],
    "scores": 
    [
      {
        "provider": {"type":"string"},
        "type": {"type":"string"},
        "value": {"type":"number"}
      }
    ]
  },
  "organizations": 
  [
    {
      "title": {"type":"string"},
      "name": {"type":"string"},
      "startDate": {"type":"string"},   // formatted as "YYYY-MM"
      "endDate": {"type":"string"},     // formatted as "YYYY-MM"
      "isPrimary": {"type":"boolean"}
      "current": {"type":"boolean"}
    }
  ]
}

Lookup by Twitter

Use the person method to request more information about a specific person by twitter.

JSON

https://api.fullcontact.com/v2/person.json?twitter=lorangb&apiKey=xxxx

XML

https://api.fullcontact.com/v2/person.xml?twitter=lorangb&apiKey=xxxx

HTML

https://api.fullcontact.com/v2/person.html?twitter=lorangb&apiKey=xxxx

Parameters

apiKey

This API key is assigned to you by FullContact. It is used to identify and authorize your request. Your API key should be kept private, and should never be displayed publicly.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&apiKey=xxxx

twitter

The twitter name of the person being looked up.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&apiKey=xxxx

queue (optional)

Using this parameter notifies FullContact that the email address in question will be called later. It allows the API to make sure it has indexed the email address prior to the application needing it. When using this parameter, it will always return a response code of 202.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&queue=1&apiKey=xxxx

callback (optional)

If specified, the response will be wrapped as JSONP in a function call. For example, by specifying callback=myCallback the resulting JSON will be:

https://api.fullcontact.com/v2/person.json?twitter=lorangb&callback=myCallback&apiKey=xxxx

Callback Example

myCallback ({
    ...response...
})

css (optional)

The css parameter can be used to customize the look of person.html.

HTML Only

https://api.fullcontact.com/v2/person.html?twitter=lorangb&apiKey=xxxx&css=http://url_to_your_stylesheet

Download the person.html stylesheet template. This includes the default stylesheet used by FullContact, a sample Person html file and a template stylesheet for your custom styles.

prettyPrint (optional)

The prettyPrint parameter can be used to disable prettyprint formatting on the API response.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&apiKey=xxxx&prettyPrint=false

webhooksUrl (required for webhooks only)

View Webhook flow diagram

For the webhookUrl parameter, enter the callback url you'd like the data to be posted back to (ie. https://mydomain.com/callback/listener). The webhookUrl must be URL encoded

When you include the webhookUrl parameter in your API request, an HTTP POST request will be triggered to the URL you've specified. The payload of the response POSTed to the webhook URL is by default formatted as a URL-encoded form with the contents of the "result" form/post parameters being a URL-encoded JSON document. This is the format regardless of whether the initial request to v2/Person was to the .json, .xml or .html version of the person endpoint.

When testing webhooks during development, we recommend intercepting the webhook POST requests locally, or using a web-based webhook testing service likeRequestb.in. Requestb.in lets you debug webhooks by capturing and logging the asynchronous requests made when events happen. Create a Requestb.in URL and insert the URL provided into the webhookUrl parameter of your API request. All messages POSTed to the Requestb.in URL will be available almost immediately after you initiate a webhook-based request.

NOTE: We will make 3 attempts to deliver the payload, waiting a minimum of 2 seconds between each attempt. If a 200 response is not received within 3 attempts, the request will be dropped.

BLACKLISTING: If FullContact can’t deliver at least 10 consecutive, successful messages to a specified URI over a 5 minute period, we will temporarily impose a 5 minute blacklisting of the URI. After the 5 minutes has elapsed, the blacklist will be automatically removed and FullContact will resume webhook delivery attempts.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&webhookUrl=myWebhookUrl&apiKey=xxxx

Example Encoded Webhook URL

http%3A%2F%2Fmydomain.com%2Fwebhook

webhookId (optional)

You can enter anything you want here, we will just pass it back in the response. This allows you to track the webhook if you wish.

https://api.fullcontact.com/v2/person.json?twitter=lorangb&webhookUrl=myWebhookUrl&webhookId=myId&apiKey=xxxx

Webhook Example Response

result = {
    "status": 200,
    "contactInfo": {
        "familyName": "Lorang",
        "givenName": "Bart",
        "fullName": "Bart Lorang",

        *** results truncated ***
}

webhookId =  "myId"

Example Responses

The API responds with JSON, HTML, or XML.

JSON

{
  "status": 200,
  "likelihood": 0.9,
  "requestId": "773e6782-62bb-4fc6-9f38-28ea0b5db261",  
  "contactInfo": {
    "familyName": "Lorang",
    "givenName": "Bart",
    "fullName": "Bart Lorang",
    "websites": 
    [
      {
        "url": "https://www.fullcontact.com"
      }
    ]
  },
  "demographics": {
    "age": "33",
    "locationGeneral": "Boulder, Colorado",
    "locationDeduced" : {
      "normalizedLocation" : "Boulder, Colorado",
      "deducedLocation" : "Boulder, Colorado, United States",
      "city" : {
        "deduced" : false,
        "name" : "Boulder"
      },
      "state" : {
        "deduced" : false,
        "name" : "Colorado",
        "code" : "CO"
      },
      "country" : {
        "deduced" : true,
        "name" : "United States",
        "code" : "US"
      },
      "continent" : {
        "deduced" : true,
        "name" : "North America"
      },
      "county" : {
        "deduced" : true,
        "name" : "Boulder",
        "code" : "Boulder"
      },
      "likelihood" : 1.0
    },  
    "gender": "Male",
    "ageRange": "25-34"
  },
  "socialProfiles": 
  [
    {
      "typeId": "twitter",
      "typeName": "Twitter",
      "url": "http://www.twitter.com/bartlorang",
      "id": 5998422,
      "username": "lorangb",
      "bio": "CEO & Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.",
      "followers": 631,
      "following": 485,
      "rss": "http://twitter.com/statuses/user_timeline/bartlorang.rss"
    },
    {
      "typeId": "linkedin",
      "typeName": "Linkedin",
      "url": "http://www.linkedin.com/in/bartlorang",
      "id": "6xtewkyGle",
      "username": "bartlorang",
      "bio": "Co-Founder & CEO at FullContact",
      "following": 1071,
      "followers": 1071
    },
    {
      "url": "http://about.me/lorangb",
      "username": "lorangb",
      "typeId": "aboutme",
      "typeName": "About Me"
    },
    {
      "url": "http://profiles.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleprofile",
      "typeName": "Google Profile"
    },
    {
      "url": "http://www.quora.com/bart-lorang",
      "username": "bart-lorang",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "http://foursquare.com/lorangb",
      "username": "lorangb",
      "typeId": "foursquare",
      "typeName": "Foursquare",
      "id": "10245647"
    },
    {
      "url": "http://youtube.com/user/lorangb",
      "username": "lorangb",
      "rss": "http://youtube.com/rss/user/lorangb/videos.rss",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "http://picasaweb.google.com/lorangb",
      "id": "114426306375480734745",
      "username": "lorangb",
      "rss": "http://picasaweb.google.com/data/feed/base/user/lorangb",
      "typeId": "picasa",
      "typeName": "Picasa"
    },
    {
      "url": "http://plancast.com/lorangb",
      "id": "1634762",
      "username": "lorangb",
      "typeId": "plancast",
      "typeName": "Plancast"
    },
    {
      "url": "https://plus.google.com/114426306375480734745",
      "id": "114426306375480734745",
      "username": "lorangb",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    },
    {
      "typeId": "klout",
      "typeName": "Klout",
      "url": "http://www.klout.com/lorangb",
      "username": "lorangb"
    },
    {
      "url": "http://www.flickr.com/photos/39267654@N00/",
      "id": "39267654@N00",
      "rss": "http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00",
      "typeId": "flickr",
      "typeName": "Flickr"
    }
  ],
 "organizations": [
    {
        "isPrimary": true,
        "name": "FullContact",
        "startDate": "2010-01",
        "title": "Co-Founder & CEO",
        "current": true
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2009-06",
        "endDate": "2009-12",
        "title": "Owner",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2002-06",
        "endDate": "2006-06",
        "title": "Chief Technology Officer",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "1996-06",
        "endDate": "2002-06",
        "title": "Partner / Development Manager",
        "current": false
    },
    {
        "isPrimary": false,
        "name": "Dimension Technology Solutions",
        "startDate": "2006-06",
        "endDate": "2009-06",
        "title": "President",
        "current": false
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": "entrepreneurship",
        "provider": "klout"
      },
      {
        "value": "angel investing",
        "provider": "klout"
      },
      {
        "value": "techstars",
        "provider": "klout"
      },
      {
        "value": "boulder",
        "provider": "klout"
      },
      {
        "value": "tequila",
        "provider": "klout"
      }
    ],
    "scores": 
    [
      {
        "provider": "klout",
        "type": "general",
        "value": 61
      }
    ]
  },
  "photos": 
  [
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381",
      "typeId": "twitter",
      "typeName": "Twitter"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9",
      "typeId": "linkedin",
      "typeName": "Linkedin"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a",
      "typeId": "quora",
      "typeName": "Quora"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36",
      "typeId": "youtube",
      "typeName": "Youtube"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d",
      "typeId": "foursquare",
      "typeName": "Foursquare"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d",
      "typeId": "googleplus",
      "typeName": "Google Plus"
    }
]}

HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title>Bart Lorang</title>
</head>

<body>
  <div id="cotactInfo">
    <table style=
    "font-family:Arial,Helvetica; font-size: 13px;padding:10px; border:0px; -moz-border-radius:4px;-webkit-border-radius:4px; border-radius:4px;">
    <tr>
        <td class="contactPhoto" valign="top" style=
        "vertical-align: top; text-align: left;">
          <div style=
          "margin-right:10px; border:3px solid #dddddd; min-height:77px; min-width:77px;">
          <img style="height:80px; width:80px;padding:0px;margin:0px" width="80" height=
          "80" src=
          "https://d2ojpxxtu63wzl.cloudfront.net/static/cf9e151530e386f6d86450206fd1345a_ea1f4c9ffb6856596b3df04b6b797de722f79a9781ba29bf172c52136f576557"
          alt="" /></div>
        </td>
        <td valign="top" style="vertical-align: top; text-align: left;">
          <table>
            <tr>
              <td id="name" style=
              "vertical-align: top; text-align: left; padding-bottom:5px; font-weight:bold; font-size:18px;">
              Bart Lorang</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "font-weight:bold;vertical-align: top; text-align: left;padding-bottom:1px;font-size: 18px;">
              Chief Executive Officer and Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="age" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Male, 33 years
              old</td>
              <td></td>
            </tr>
            <tr>
              <td id="location" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Boulder,
              Colorado, United States</td>
              <td></td>
            </tr>
            <tr>
              <td id="socialProfiles" style="vertical-align: top; text-align: left;">
              <a target="_blank" href="http://www.twitter.com/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/twitter_16.png" /></a>
              <a target="_blank" href="http://www.linkedin.com/in/bartlorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/linkedin_16.png" /></a>
              <a target="_blank" href="http://about.me/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/aboutme_16.png" /></a>
              <a target="_blank" href="http://profiles.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleprofile_16.png" />
              </a> <a target="_blank" href="http://www.quora.com/bart-lorang"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/quora_16.png" /></a>
              <a target="_blank" href="http://foursquare.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/foursquare_16.png" />
              </a> <a target="_blank" href="http://youtube.com/user/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/youtube_16.png" /></a>
              <a target="_blank" href="http://picasaweb.google.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/picasa_16.png" /></a>
              <a target="_blank" href="http://plancast.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/plancast_16.png" /></a>
              <a target="_blank" href=
              "https://plus.google.com/114426306375480734745"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/googleplus_16.png" />
              </a> <a target="_blank" href="http://www.klout.com/lorangb"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/klout_16.png" /></a>
              <a target="_blank" href="http://www.myspace.com/137200880"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/myspace_16.png" /></a>
              <a target="_blank" href=
              "http://www.flickr.com/photos/39267654@N00/"><img style=
              "border:none; width:16px; height:16px; margin-right:3px;" width="16"
              height="16" src=
              "https://api.fullcontact.com/images/socialProfileIcons/flickr_16.png" /></a></td>
              <td></td>
            </tr>
            <tr>
              <td>Other Organizations:</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">CEO &amp;
              Co-Founder, FullContact</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Techstars</td>
              <td></td>
            </tr>
            <tr>
              <td id="position-company" style=
              "vertical-align: top; text-align: left;padding-bottom:1px;">Co-Founder
              &amp; CEO, Rainmaker Technologies</td>
              <td></td>
            </tr>
            <tr>
              <td></td>
            </tr>
          </table>
        </td>
      </tr>
    </table>
    <table style="width: 100%" width="100%">
      <tr>
        <td style="text-align:right"><span style=
        "font-size:9px;margin-right:50px;">Provided By</span><br />
        <a href="https://www.fullcontact.com/"><img style="border:none;" src=
        "http://api.fullcontact.com/images/fullcontactlogo_sm.png" alt=
        "Provided by FullContact" /></a></td>
      </tr>
    </table>
  </div>
</body>
</html>

XML

<?xml version="1.0" encoding="UTF-8" ?>
<person>
  <status>200</status>
  <requestId>773e6782-62bb-4fc6-9f38-28ea0b5db261</requestId>
  <likelihood>0.9</likelihood> 
  <contactInfo>
    <familyName>Lorang</familyName>
    <givenName>Bart</givenName>
    <fullName>Bart Lorang</fullName>
    <websites>
      <website>
        <url>https://www.fullcontact.com</url>
      </website>
    </websites>
  </contactInfo>
  <photos>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ecf57683e2c22abb296f822377597290_fe346265298c3d008a4af9c54483809f55508dd4c238789dc9a115ae8395c381</url>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/76fa9f05dce661f3dfbff6c2ea680cd7_c3360fe21ad70bde88addb0517369e17b6de0d94b85268e20688deda96d6b0a9</url>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
    </photo>
    <photo>
 <url>https://d2ojpxxtu63wzl.cloudfront.net/static/a508fc51b2d287175f36a44aead7438a_6be07253a0bbaf5929d148cc2fca7f266ffd41a1053862e2f3016594a134602d</url>
      <type>googleplus</type>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/image/45615034145b3b980973fdf87b213b81_97e5bd895444901bcfd4008362cb1008f617134ef6a8396eb292aed814a70c9a</url>
      <type>quora</type>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/c1c2dfa135fa60399c4c1e3e1b8f7ace_9964024ac3eb12645ba7a4bec7aee722ad7735eb413b21a2b9bb008159aeda36</url>
      <type>youtube</type>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </photo>
    <photo>
      <url>https://d2ojpxxtu63wzl.cloudfront.net/static/ac4cac11df61b43c503d4c3101604742_80a63ae50b5cc0e8f9dacb522547d923f1b3961ca666fd661fb2b3f5656a644d</url>
      <type>foursquare</type>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
    </photo>
  </photos>
  <demographics>
    <locationGeneral>Boulder, Colorado</locationGeneral>
    <locationDeduced>
      <normalizedLocation>Boulder, Colorado</normalizedLocation>
      <deducedLocation>Boulder, Colorado, United States</deducedLocation>
      <city>
        <deduced>false</deduced>
        <name>Boulder</name>
      </city>
      <state>
        <deduced>false</deduced>
        <name>Colorado</name>
        <code>CO</code>
      </state>
      <country>
        <deduced>true</deduced>
        <name>United States</name>
        <code>US</code>
      </country>
      <continent>
        <deduced>true</deduced>
        <name>North America</name>
      </continent>
      <county>
        <deduced>true</deduced>
        <name>Boulder</name>
        <code>Boulder</code>
      </county>
      <likelihood>1.0</likelihood>
    </locationDeduced>
    <age>33</age>
    <gender>Male</gender>
    <ageRange>25-34</ageRange>
  </demographics>
  <socialProfiles>
    <socialProfile>
      <type>twitter</type>
      <typeId>twitter</typeId>
      <typeName>Twitter</typeName>
      <url>http://www.twitter.com/bartlorang</url>
      <id>5998422</id>
      <username>lorangb</username>
      <bio>CEO &amp; Co-Founder of @FullContactAPI - Tech Entrepreneur and Angel Investor.</bio>
      <followers>637</followers>
      <following>485</following>
      <rss>http://twitter.com/statuses/user_timeline/bartlorang.rss</rss>
    </socialProfile>
    <socialProfile>
      <type>linkedin</type>
      <typeId>linkedin</typeId>
      <typeName>Linkedin</typeName>
      <url>http://www.linkedin.com/in/bartlorang</url>
      <id>6xtewkyGle</id>
      <username>bartlorang</username>
      <bio>Co-Founder &amp; CEO at FullContact</bio>
      <following>1071</following>
      <followers>1071</followers>
    </socialProfile>
    <socialProfile>
      <url>http://about.me/lorangb</url>
      <type>aboutme</type>
      <username>lorangb</username>
      <typeId>aboutme</typeId>
      <typeName>About Me</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://profiles.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>googleprofile</type>
      <username>lorangb</username>
      <typeId>googleprofile</typeId>
      <typeName>Google Profile</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.quora.com/bart-lorang</url>
      <type>quora</type>
      <username>bart-lorang</username>
      <typeId>quora</typeId>
      <typeName>Quora</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://foursquare.com/lorangb</url>
      <type>foursquare</type>
      <username>lorangb</username>
      <typeId>foursquare</typeId>
      <typeName>Foursquare</typeName>
      <id>10245647</id>
    </socialProfile>
    <socialProfile>
      <url>http://youtube.com/user/lorangb</url>
      <type>youtube</type>
      <username>lorangb</username>
      <rss>http://youtube.com/rss/user/lorangb/videos.rss</rss>
      <typeId>youtube</typeId>
      <typeName>Youtube</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://picasaweb.google.com/lorangb</url>
      <id>114426306375480734745</id>
      <type>picasa</type>
      <username>lorangb</username>
   <rss>http://picasaweb.google.com/data/feed/base/user/lorangb?kind=album&amp;alt=rss&amp;hl=en_US&amp;access=public</rss>
      <typeId>picasa</typeId>
      <typeName>Picasa</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://plancast.com/lorangb</url>
      <id>1634762</id>
      <type>plancast</type>
      <username>lorangb</username>
      <typeId>plancast</typeId>
      <typeName>Plancast</typeName>
    </socialProfile>
    <socialProfile>
      <url>https://plus.google.com/114426306375480734745</url>
      <id>114426306375480734745</id>
      <type>googleplus</type>
      <username>lorangb</username>
      <typeId>googleplus</typeId>
      <typeName>Google Plus</typeName>
    </socialProfile>
    <socialProfile>
      <type>klout</type>
      <typeId>klout</typeId>
      <typeName>Klout</typeName>
      <url>http://www.klout.com/lorangb</url>
      <username>lorangb</username>
    </socialProfile>
    <socialProfile>
      <url>http://www.myspace.com/137200880</url>
      <type>myspace</type>
      <typeId>myspace</typeId>
      <typeName>Myspace</typeName>
    </socialProfile>
    <socialProfile>
      <url>http://www.flickr.com/photos/39267654@N00/</url>
      <id>39267654@N00</id>
      <type>flickr</type>
      <rss>http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00&amp;lang=en-us&amp;format=rss_200</rss>
      <typeId>flickr</typeId>
      <typeName>Flickr</typeName>
    </socialProfile>
  </socialProfiles>
  <organizations>
    <organization>
      <isPrimary>true</isPrimary>
      <name>FullContact</name>
      <title>Co-founder &amp; CEO</title>
      <startDate>2010-01</startDate>
      <current>true</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2009-06</startDate>
      <endDate>2009-12</endDate>
      <title>Owner</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2002-06</startDate>
      <endDate>2006-06</endDate>
      <title>Chief Technology Officer</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>1996-06</startDate>
      <endDate>2002-06</endDate>
      <title>Partner/Development Manager</title>      
      <current>false</current>
    </organization>
    <organization>
      <isPrimary>false</isPrimary>
      <name>Dimension Technology Solutions</name>
      <startDate>2006-06</startDate>
      <endDate>2009-06</endDate>
      <title>President</title>      
      <current>false</current>
    </organization>
  </organizations>
  <digitalFootprint>
    <topics>
      <topic>
        <value>entrepreneurship</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>angel investing</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>techstars</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>boulder</value>
        <provider>klout</provider>
      </topic>
      <topic>
        <value>tequila</value>
        <provider>klout</provider>
      </topic>
    </topics>
    <scores>
      <score>
        <provider>klout</provider>
        <type>general</type>
        <value>61</value>
      <score>
    </scores>
  </digitalFootprint>
</person>

Response Schema

The following is a description of the Person API response schema. It includes every possible field, collection, and value you can expect to receive. Note that certain fields and collections will only appear in the response when the data is available.

{
  "status": {"type":"number"},
  "requestId": {"type":"string"},
  "likelihood": {"type":"number"},
  "contactInfo": {
    "familyName": {"type":"string"},
    "givenName": {"type":"string"},
    "fullName": {"type":"string"},
    "middleNames": 
    [
      {"type":"string"}
    ],
    "websites": 
    [
      {
        "url": {"type":"string"}
      }
    ],
    "chats": 
    [
      {
        "handle": {"type":"string"},
        "client": {"type":"string"}
      }
    ]
  },
  "demographics": {
    "locationGeneral": {"type":"string"},
    "locationDeduced": {
      "normalizedLocation": {"type":"string"},
      "deducedLocation" : {"type":"string"},
      "city" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "state" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "country" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "continent" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"}
      },
      "county" : {
        "deduced" : {"type":"boolean"},
        "name" : {"type":"string"},
        "code" : {"type":"string"}
      },
      "likelihood" : {"type":"number"}
    },
    "age": {"type":"string"},
    "gender": {"type":"string"},
    "ageRange": {"type":"string"}
  },
  "photos": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "url": {"type":"string"},
      "isPrimary": {"type":"boolean"}
    }
  ],
  "socialProfiles": 
  [
    {
      "typeId": {"type":"string"},
      "typeName": {"type":"string"},
      "id": {"type":"string"},
      "username": {"type":"string"},
      "url": {"type":"string"},
      "bio": {"type":"string"},
      "rss": {"type":"string"},
      "following": {"type":"number"},
      "followers": {"type":"number"}
    }
  ],
  "digitalFootprint": {
    "topics": 
    [
      {
        "value": {"type":"string"},
        "provider": {"type":"string"}
      }
    ],
    "scores": 
    [
      {
        "provider": {"type":"string"},
        "type": {"type":"string"},
        "value": {"type":"number"}
      }
    ]
  },
  "organizations": 
  [
    {
      "title": {"type":"string"},
      "name": {"type":"string"},
      "startDate": {"type":"string"},   // formatted as "YYYY-MM"
      "endDate": {"type":"string"},     // formatted as "YYYY-MM"
      "isPrimary": {"type":"boolean"}
      "current": {"type":"boolean"}
    }
  ]
}

Person API Flow Diagram

Person Flow Diagram

Person API Webhook Flow Diagram

Person Flow Diagram with Webhooks