DEVELOPER GUIDE
Stable
Person -ID Investigation Ordering Guide
Overview
Your system is ordering a Person -ID Investigation or a Person -Criminal+W&A+SexOffender (aka IDInvestigation).
This same order type is also offered as the product Person -Criminal+W&A+SexOffender. The request and response are identical between the two — the product name configured indicates the specialized configuration on the backend.
Get the URL from your Pitchpoint Account Representative of where you should be submitting your orders to.
Step 1: Authenticate and Receive Tokens
Refer to the Authentication Guide for detailed steps on authentication and token retrieval.
Step 2: Place an order
This request submits the order details.
Include the access token in the Authorization header following the Bearer keyword. Replace your_access_token_here with the actual token you obtained during the authentication process.
For further explanation of required mandatory fields and their meanings, refer to Person -ID Investigation API Reference
Example request
The following example orders an IDInvestigation report.
curl -X POST https://api.pointservices.com/riskinsight-services-ws/resources/v1/sami/IDInvestigation/PDF-001
-H "Authorization: Bearer your_access_token_here"
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
"CorrelationID" : "idinvestigation-001",
"Terms" : {
"Term" : [ {
"Person" : {
"FirstName" : "Daffy",
"LastName" : "Duckerson",
"SSN" : "123121234",
"DOB" : "12/17/1976",
"HomePhone" : "1234567890",
"Residences" : {
"Residence" : [ {
"Address" : {
"AddressLine1" : "123 Main St",
"City" : "Anytown",
"State" : "CA",
"PostalCode" : "12345"
},
"CurrentIndicator" : true
} ]
}
}
} ]
}
}'
Example response
{
"TransactionID" : "0000000000011038342",
"CorrelationID" : "idinvestigation-001",
"Terms" : {
"Term" : [ {
"Person" : {
"FirstName" : "Daffy",
"LastName" : "Duckerson",
"SSN" : "123121234",
"DOB" : "12/17/1976",
"HomePhone" : "1234567890",
"Residences" : {
"Residence" : [ {
"Address" : {
"AddressLine1" : "123 Main St",
"City" : "Anytown",
"State" : "CA",
"PostalCode" : "12345"
},
"CurrentIndicator" : true
} ]
}
}
} ]
},
"Attachments" : {
"Attachment": [
{
"Properties": null,
"Extension": null,
"Document": "JVBERi0xLjUKJd/++LIKM...bDTZTKJGBAQAjRAajCmVuZHN0cmVhbQplbmRvYmoKCnN0YXJ0eHJlZgo0NzA1CiUlRU9GCg==",
"Classifier": "report",
"ContentDisposition": "inline; filename=\"IDInvestigationReport\"; creation-date=\"Sun, 02 Aug 2026 01:43:13 UTC\"; modification-date=\"Sun, 02 Aug 2026 01:43:13 UTC\"; read-date=\"Sun, 02 Aug 2026 01:43:13 UTC\"; size=5008",
"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/0000000000011038342"
}
After submitting, you may have to wait a few minutes for the request to finish processing. When the request has returned, the results of the submission will be in the Messages.Message.Code section. A Status.Code of S001 indicates that the order was a billable transaction.
You can use the url provided in the Ref field to retrieve the order results again.
Other Examples
Missing Input Data
SSN, DOB, HomePhone, and the Residence.Address.* fields are missing.
curl -X POST https://api.pointservices.com/riskinsight-services-ws/resources/v1/sami/IDInvestigation/PDF-001
-H "Authorization: Bearer your_access_token_here"
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
"CorrelationID" : "idinvestigation_missing_fields",
"Terms" : {
"Term" : [ {
"Person" : {
"FirstName" : "Daffy",
"LastName" : "Duckerson",
"SSN" : "",
"DOB" : "",
"HomePhone" : "",
"Residences" : {
"Residence" : [ {
"Address" : {
"AddressLine1" : "",
"City" : "",
"State" : "",
"PostalCode" : ""
},
"CurrentIndicator" : true
} ]
}
}
} ]
}
}'
Example Response
In this response, we see that Messages.Message.Category = Fault so we know that the submission of this order failed. Check the Messages.Message.Description for more details on how to correct.
{
"TransactionID": "0000000000013284314",
"CorrelationID": "idinvestigation_missing_fields",
"Meta": null,
"Preferences": null,
"Terms": {
"Term": [
{
"Person": {
"FirstName": "Daffy",
"MiddleName": null,
"LastName": "Duckerson",
"NameSuffix": null,
"SSN": "",
"DOB": "",
"YOB": null,
"Gender": null,
"HomePhone": "",
"Residences": {
"Residence": [
{
"Address": {
"AddressLine1": "",
"City": "",
"State": "",
"PostalCode": "",
"AddressLine2": null,
"AddressLine3": null,
"County": null
},
"CurrentIndicator": true
}
]
},
"Employers": null,
"EthnicGroup": null,
"EyeColor": null,
"BankAccounts": null,
"Declarations": null,
"CreditReportIdentifier": null,
"CourtDetails": null,
"Email": null,
"ConsentTokens": null,
"Properties": null
}
}
]
},
"Attachments": null,
"Messages": {
"Message": [
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/Residence[1]/Address/AddressLine1 is required."
},
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/BirthDate is required."
},
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/TaxIdentification[1]/TaxIdentificationNumber is required."
},
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/Residence[1]/Address/Region is required."
},
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/Residence[1]/Address/PostalCode is required."
},
{
"Category": "Fault",
"Code": "E004",
"Description": "/Inputs[1]/Input[1]/Loan[1]/Borrower[1]/Residence[1]/Address/City is required."
}
]
},
"Status": {
"Code": "U001",
"Description": "Unserviceable"
},
"Ref": "https://api.pointservices.com/riskinsight-services-ws/resources/v1/sami/0000000000013284314"
}