Searches for a telephone number with in the United States. You may search for multiple numbers at a time. SearchBy indicates how you wish for the pattern field to be interpreted: 0) None -- The pattern is ignored and a random list of numbers will be returned. 1) AreaCode -- The pattern indicates a NANP area code to search with in. 2) CityState -- The pattern indicates a city state to search within. (E.g. "Austin, TX") 3) ZipCode -- The pattern is a 5 digit US zip code to search within. (E.g. "78746")

Request URL

POST   https://api.3seventy.com/api/v2.1/account/{accountId}/search-for-tn

Request Properties

Parameter Description Mandatory
accountId The account which is performing the search. Yes
Quantity How many phone numbers to search for. Yes
Pattern The search pattern to use when looking for an available number. Yes
SearchBy How we should interpret the search pattern. Yes

Response Properties

Property Description
Id ID for later reference.
RequestedQuantity The number of phone numbers requested.
Pattern The search pattern that was used.
SearchBy The type of search that was performed.
Created When the search was preformed.
ExpirationDate When we will no longer allow using this search item for orders.
PhoneNumbers List of phone numbers that were found.


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Linq;
using ThreeSeventy.Vector.Client;
using ThreeSeventy.Vector.Client.Enums;
using ThreeSeventy.Vector.Client.Models;

public class Program

private static void Main(string[] args)

const int accountId = XXXX;

var context = new T70Context();

var searchTnRepo = context.Repository<SearchTn>(new { AccountId = accountId });

var item = new SearchTn()


AccountId = accountId,

SearchBy = SearchBy.AreaCode,

Pattern = "XXXX",

RequestedQuantity = 1






Stay tuned for JAVA code snippet
Stay tuned for RUBY code snippet
Stay tuned for PHP code snippet