API Documentation

Cell Phone Append.

Start with a name and address, get back a cell phone number and the carrier it belongs to. You're only billed when there's a match.

Endpoint: https://rapid.peachtreedata.com/api/v1/cellphoneappend
Methods: GET — one individual or household per request
Formats: JSON by default; append .xml for XML

Authentication

Every request carries your API key in the query string. The API is HTTPS-only, so the key is encrypted in transit. Query parameters can appear in any order, and responses are JSON by default — append .xml to the endpoint for XML.

https://rapid.peachtreedata.com/api/v1/cellphoneappend?apikey={apikey}&…

Don't have a key? Sign up under plans & pricing below — keys work immediately.

Request

Parameter	Required	Description
apikey	Yes	Your unique API key.
firstName	—	First name of the individual.
lastName	Yes	Last name of the individual or household.
address1	Yes	Street address portion. Example: 111 Main St.
address2	—	Secondary address, usually the suite or apartment number.
city	—	City name. City + state or ZIP Code is required.
state	—	State name or abbreviation. City + state or ZIP Code is required.
zip	—	ZIP Code. City + state or ZIP Code is required.
requestId	—	Any identifier you choose; echoed back in the response.

Addresses must include city + state, or a ZIP Code.

Examples

Lookup (GET)

curl "https://rapid.peachtreedata.com/api/v1/cellphoneappend?apikey={apikey}\
&firstName=John&lastName=Doe\
&address1=111+Main+St&zip=30097&requestId=222"

Matched response — billable

{
  "telcoName": "",
  "phoneNumber": "6784730000",
  "status": "Match",
  "billable": true,
  "requestId": "222"
}

No-match response — not billed

{
  "status": "NoMatch",
  "billable": false,
  "requestId": "222"
}

Response reference

Field	Type	Description
phoneNumber	String(10)	Ten-digit cell phone number.
telcoName	String(60)	The telephone company the matched cell phone number belongs to.
status	String(7)	Match — number found. NoMatch — number not found. Error — a processing error occurred.
statusMessage	String(200)	When status is Error, the description.
billable	Boolean	Whether this request will be billed. Only requests with a matching append result are billed.
requestId	String(50)	Echo of the requestId you sent, unchanged.

HTTP response codes

Code	Description
200	Processed successfully.
400	Bad request — the API key format is invalid, the key is missing, or the input wasn't properly passed.
401	Unauthorized — the API key is inactive or invalid.
403	Forbidden — the request exceeds the max items allowed per call, or the account isn't set up for this service.
408	Request timeout — processing exceeded the max processing time.
500	Internal server error during processing.

Plans & pricing

$100/mo

1,000 matches per month

$0.095 per match above 1,000 in a month.

Only matches count against your quota — no-match lookups are free. Need higher volume or invoicing? Talk to us.

Reaching customers on their cell?

Tell us what you're building and we'll get you moving — usually the same day.

Send Us a Note 678-987-4600