×

Login to Safe Shepherd

Recover your password

Safe Shepherd API Documentation

Get user

Gets details for user

GET /api/:integration_name/:api_key/v2/users/:id(.:format)

Parameters

api_key
API access key - String*
api_secret
API secret key - String*
id
User id returned during user creation - Integer*
secret
Secret associated with user account during creation - Integer*

Returns

HTTP 401 - Unauthorized

If api_key missing or invalid, or user-secret failed authorization.

HTTP 400 - Bad Request

If fields missing or invalid

HTTP 200 - Success

Returns JSON/XML-encoded struct { user: <details for given user (see example)> }

View Example
{
  "user": {
    "id": 12,
    "secret": "TOP SECRET",
    "birth_date": null,
    "first_name": "Tommy",
    "middle_name": "Lee",
    "last_name": "Jones",
    "aliases": [
      {
        "id": 123,
        "first_name": "Tom",
        "last_name": "Yorke"
      }
    ],
    "emails": [
      {
        "id": 123,
        "address": "tom@example.com"
      }
    ],
    "phone_numbers": [
      {
        "id": 123,
        "number": "3128881212"
      },
      {
        "id": 124,
        "number": "2153331212"
      }
    ],
    "addresses": [
      {
        "id": 123,
        "address1": "123 N Jones Street",
        "address2": null,
        "city": "Pasadena",
        "state": "CA",
        "zip": "91101"
      }
    ],
    "records": [
      {
        "id": 318,
        "name": "Tommy Lee Jones",
        "site": "Intelius",
        "status": "discovered",
        "age": null,
        "href": null,
        "relations": [
          "Maria Jones",
          "Jesse Jones"
        ],
        "aliases": [
          "Thom"
        ],
        "locations": [
          "Glendale, CA",
          "Pasadena, CA",
          "North Hollywood, CA"
        ],
        "reference_id": "000560228488",
        "user_fields_required_for_removal": [
          "first_name",
          "address1"
        ]
      }
    ],
    "links": [
      {
        "url": "http://github.com/hayesgm",
        "title": "Github | hayesgm",
        "contains": [
          "email",
          "address"
        ]
      }
    ],
    "service_history": [
      {
        "activated_service_on": "2012/05/27 00:46:39 +0000"
      },
      {
        "deactivated_service_on": "2012/05/30 00:46:39 +0000"
      },
      {
        "activated_service_on": "2012/06/01 00:46:39 +0000"
      }
    ],
    "is_scanning": false,
    "identification_on_file": true
  }
}

Notes

This can be called at any given time to get details for a given user.