API REFERENCEv1

Find Contact

GEThttps://api2.protexting.com/v1/contacts/find

⌘

Pass your server-side token as access_token. Replace sample values with your own. Authentication & setup →

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:

Request example

1# Set PROTEXTING_ACCESS_TOKEN in your environment2curl --request GET \3  "https://api2.protexting.com/v1/contacts/find?number=16461234567&access_token=${PROTEXTING_ACCESS_TOKEN:?Set your API token}" \4  --header 'Accept: application/json'

Server-side exampleJSON · HTTPS

Example Response Headers:

Response headers example

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

Example Response Body:

JSON response example

1{
2        "Id": 1,
3        "Number": "16461234567",
4        "OptedOut": 0,
5        "FirstName": "John",
6        "LastName": "Smith",
7        "BirthDay": "0000-00-00",
8        "Email": "",
9        "Zip": "",
10        "City": "",
11        "DateCreated": "2015-01-20 10:21:29",
12        "DateUpdated": "2015-01-20 10:21:29",
13        "GroupIds": [1,2],
14        "CustomFieldIds":[]
15}

XML response example

1<response>2   <item>3      <Id>1</Id>4      <Number>16461234567</Number>5      <OptedOut>0</OptedOut>6      <FirstName>John</FirstName>7      <LastName>Smith</LastName>8      <BirthDay>0000-00-00</BirthDay>9      <Email/>10      <Zip/>11      <City/>12      <DateCreated>2015-01-20 10:21:29</DateCreated>13      <DateUpdated>2015-01-20 10:21:29</DateUpdated>14      <GroupIds>15         <item>1</item>16         <item>2</item>17      </GroupIds>18      <CustomFieldIds/>19   </item>20</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 »

← PreviousDelete Contact Next →Opt in Contact Flow

Reference from the ProTexting documentation catalog. Code examples are illustrative; this page does not execute API requests.