API REFERENCE

Stable

Person -Property Ownership

Ordering a Person -Property Ownership (aka ForeclosureInvestigation) product.

Get the URL from your Pitchpoint Account Representative of where you should be submitting your orders to.

• Sample
  • Header Properties
  • Request Data Properties
    • Terms.Term.Person
• Responses
  • Attachments.Attachment

Sample

url="https://api.pointservices.com/riskinsight-services-ws/resources/v1/sami/ForeclosureInvestigation/PDF-001"
curl -X POST "${url}"
-H "Authorization: Bearer your_access_token_here"
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
  "CorrelationID" : "request-1",
  "Terms" : {
    "Term" : [ {
      "Person" : {
        "FirstName" : "Daffy",
        "LastName" : "Duckerson",
        "SSN" : "123121234",
        "DOB" : "12/17/1976"
      }
    } ]
  }
}
'

Header Properties

Property	Value	Required?
Content-Type	application/json	true
Accept	application/json	true
X-PPS-UserAlias	your value	false
X-PPS-Authorization-Alias	your value	false
X-PPS-CorrelationID	your value	false

See the Common Headers guide for details on the optional X-PPS-* headers above.

Request Data Properties

Property	Description	Type	Default
CorrelationID	(mandatory) A user-defined reference number to help identify the order. Does not need to be unique.	string
Terms	(mandatory) See section below for more details.	object

Terms.Term.Person

Property	Description	Type
FirstName	(mandatory) First name of the person	string
LastName	(mandatory) Last name of the person	string
SSN	(mandatory) Social Security Number of the person	string
DOB	(mandatory) Date of Birth – in the MM/DD/YYYY format	string

Responses

200

The input data is echo-ed back with following additional fields:

Property	Description	Type
TransactionID	A Pitchpoint generated identifying string to uniquely identify this loan	string
	Messages.Message – A list of messages regarding the result of the order
Category	Typically one of Info or Fault to indicate whether or not this is an information message or an error message.	string
Code	Unique code for the Message. Typically, this is I001 when a report has been generated. A value starting with EXXX generally indicates an error.	string
Description	Description of the message	string
Ref	The url to query to retrieve the results of the order	string
	Status – An object that states the current status of the order as related to billing matters.
Code	The status code. This will typically be S001	string
Description	A description of the code	string
	Attachments – A list of report(s). Depending on your particular product configuration, you may get one or two reports.
Attachments	See section below for more details	object

Attachments.Attachment

Property	Description	Type
Document	A base64 encoded file	string
Classifier	Indicates what type of Attachment this is. Typically report	string
ContentDisposition	Metadata about the file	string
ContentType	The mimetype of the file	string
Extension
Extension.any	An xml representation of the report, rooted at <ForeclosureInvestigationReport	string

Example:

{
  "TransactionID": "0000000000011038341",
  "CorrelationID": "request-1",
  "Terms": {
    "Term": [
      {
        "Person": {
          "FirstName": "Daffy",
          "LastName": "Duckerson",
          "SSN": "123121234",
          "DOB": "12/17/1976"
        }
      }
    ]
  },
  "Attachments" : {
    "Attachment" : [ {
      "Properties": null,
      "Extension": {
        "any": "<ForeclosureInvestigationReport xmlns=\"\"><Input><Name><FirstName>Daffy</FirstName><LastName>Duckerson</LastName></Name><SSN>123121234</SSN></Input><Errors><Error><Message>The Social Security Number supplied is incorrect. Please verify and resubmit your order.</Message></Error></Errors></ForeclosureInvestigationReport>"
      },
      "Document": null,
      "Classifier": null,
      "ContentDisposition": null,
      "ContentType": "text/xml"
    },
      {
        "Properties": null,
        "Extension": null,
        "Document": "JVBERi0xLjUKJd/++LIKMSAwIG9iago8PC9...YW0KZW5kb2JqCgpzdGFydHhyZWYKNDE5MwolJUVPRgo=",
        "Classifier": "report",
        "ContentDisposition": "inline; filename=\"ForeclosureInvestigationPDF\"; creation-date=\"Sun, 02 Aug 2026 02:08:52 UTC\"; modification-date=\"Sun, 02 Aug 2026 02:08:52 UTC\"; read-date=\"Sun, 02 Aug 2026 02:08:52 UTC\"; size=4496",
        "ContentType": "application/pdf"
      } ]
  },
  "Messages" : {
    "Message" : [ {
      "Category" : "Info",
      "Code" : "I001",
      "Description" : "Success"
    } ]
  },
  "Status" : {
    "Code" : "S001",
    "Description" : "Serviceable"
  },
  "Ref" : "https://api.pointservices.com/riskinsight-services-ws/resources/v1/sami/0000000000011038341"
}

For a complete list of possible Message