Count Partners

Returns the total count of interconnects associated with an ECGrid ID, optionally filtered by status.

Endpoint

POST /v2/partners/count

Request Body

Field	Type	Required	Constraints	Description
ecGridId	integer	Yes	Must be a valid ECGrid ID	The ECGrid ID to count interconnects for
status	string	No	See Status enum	Filter by interconnect lifecycle status

{
  "ecGridId": 123456,
  "status": "Active"
}

Response

Returns the total count as an integer.

{
  "success": true,
  "data": 14
}

ENUMs

Status

Value	Description
Development	Interconnects in development/testing phase
Active	Live interconnects with active routing
Preproduction	Staged but not yet live
Suspended	Temporarily disabled
Terminated	Permanently ended

See Enums reference for complete enum definitions.

Code Examples

cURL

curl -X POST "https://rest.ecgrid.io/v2/partners/count" \
  -H "X-API-Key: $ECGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ecGridId": 123456, "status": "Active" }'

C#

// .NET 10 — count the active interconnects for a given ECGrid ID
using var client = httpClientFactory.CreateClient("ECGrid");

var request = new
{
    ecGridId = 123456,
    status = "Active"
};

var response = await client.PostAsJsonAsync(
    "https://rest.ecgrid.io/v2/partners/count", request);
response.EnsureSuccessStatusCode();

var result = await response.Content.ReadFromJsonAsync<ApiResponse<int>>();
Console.WriteLine($"Active interconnects: {result!.Data}");

Java

import java.net.URI;
import java.net.http.*;

String apiKey = System.getenv("ECGRID_API_KEY");

String body = "{ \"ecGridId\": 123456, \"status\": \"Active\" }";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://rest.ecgrid.io/v2/partners/count"))
    .header("X-API-Key", apiKey)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Node.js

const apiKey = process.env.ECGRID_API_KEY;
const url = 'https://rest.ecgrid.io/v2/partners/count';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ "ecGridId": 123456, "status": "Active" }),
});

const data = await response.json();
console.log(data);

Python

import os, requests

api_key = os.environ["ECGRID_API_KEY"]
headers = {"X-API-Key": api_key}
url = "https://rest.ecgrid.io/v2/partners/count"

response = requests.post(
    url,
    json={ "ecGridId": 123456, "status": "Active" },
    headers=headers,
)

response.raise_for_status()
print(response.json())

See Also

• List Partners
• Get Partner