Find Contact


URL:

https://api2.protexting.com/v1/contacts/find?number=16461234567&access_token=your_access_token


Method:

GET

Request parameters:

* required parameters

Parameter Description
* number  string, valid phone number

Response parameters:

Parameter Description
Id Phone number Id
Number Phone number
OptedOut If the contact opted out
FirstName Contact's first name
LastName Contact's last name
BirthDay Contact's birthday
Email Contact's email
Zip Contact's zip
City Contact's city
DateCreated The date when the record was created
DateUpdated The date when the record was updated
GroupIds Group Ids, array of integers, the Ids of the Groups the phone number is added to
CustomFieldIds Custom Field Ids, array of integers, the Ids of the the custom fields the contact has filled

Example Request:

 curl -i -H "Accept:application/xml" "https://api2.protexting.com/v1/contacts/find?number=16461234567&access_token=your_access_token"

 

Example Response Headers:

  Status Code: 200 OK
  Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
  Connection: Keep-Alive
  Content-Length: 257
  Content-Type: application/json; charset=UTF-8
  Keep-Alive: timeout=5, max=99
  Pragma: no-cache
  X-Powered-By: PHP/5.6.2
  X-Rate-Limit-Limit: 60
  X-Rate-Limit-Remaining: 58
  X-Rate-Limit-Reset: 0

Example Response Body:

{
        "Id": 1,
        "Number": "16461234567",
        "OptedOut": 0,
        "FirstName": "John",
        "LastName": "Smith",
        "BirthDay": "0000-00-00",
        "Email": "",
        "Zip": "",
        "City": "",
        "DateCreated": "2015-01-20 10:21:29",
        "DateUpdated": "2015-01-20 10:21:29",
        "GroupIds": [1,2],
        "CustomFieldIds":[]
}
<response>
<item>
<Id>1</Id>
<Number>16461234567</Number>
<OptedOut>0</OptedOut>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
<BirthDay>0000-00-00</BirthDay>
<Email/>
<Zip/>
<City/>
<DateCreated>2015-01-20 10:21:29</DateCreated>
<DateUpdated>2015-01-20 10:21:29</DateUpdated>
<GroupIds>
<item>1</item>
<item>2</item>
</GroupIds>
<CustomFieldIds/>
</item>
</response>

HTTP Status Codes:

The standard HTTP Status Codes are used. More information is available here: http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml

Error Codes:

Error Codes and Examples here »