Search for a virtual number using .NET

Use this guide to create a .NET application for use with the Numbers API and search for an available Sinch virtual number.

Set up your .NET application

1. Create a new folder where you want your app project. Then, open a terminal or command prompt to that location.
2. Create a new .NET console app with the following command:
   Copy

   Copied

   dotnet new console

3. Add the Newtonsoft.Json nuget package.
   Copy

   Copied

   dotnet add package Newtonsoft.Json

Modify your application

1. Open the Program.cs file in your project folder. Replace all of the code with the "Search for a virtual number" code.

   Search for a virtual number

   Copy

   using System;
   using System.Net.Http;
   using System.Threading.Tasks;
   using System.Text;
   
   public class Program
   {
     public static async Task Main(string[] args)
     {
       using (var client = new HttpClient())
       {
         var base64String = Convert.ToBase64String(Encoding.ASCII.GetBytes($"YOUR_username:YOUR_password"));
         client.DefaultRequestHeaders.Add("Authorization", "Basic "+ base64String);
         var ProjectId = "YOUR_ProjectId";
         var request = await client.GetAsync("https://numbers.api.sinch.com/v1/projects/" + ProjectId + "/availableNumbers?regionCode=US&type=LOCAL");
         var response = await request.Content.ReadAsStringAsync();
   
         Console.WriteLine(response);
       }
     }
   }
   
   

2. Save the file.

Search for an available virtual number

Fill in your parameters

1. Replace the following values in the Program.cs file:

2. Save the file.

Build and run your project

1. Before executing your code, you must first compile your application. Execute the following command:

dotnet build

2. Now you can execute the code. Run the following command:

dotnet run

Response

These steps should return a JSON list of numbers available to rent.

{
  "availableNumbers": [
    {
      "phoneNumber": "+12089087284",
      "regionCode": "US",
      "type": "LOCAL",
      "capability": ["SMS"],
      "setupPrice": {
        "currencyCode": "USD",
        "amount": "0.00"
      },
      "monthlyPrice": {
        "currencyCode": "USD",
        "amount": "2.00"
      },
      "paymentIntervalMonths": 1
    }
  ]
}

Next steps

Additional resources

• Explore the API specification to test more endpoints.
• Prefer a UI to search for a number? Follow the entire number searching and renting process in the Customer Dashboard.