Get Carbon Copy

Retrieves the details of a specific carbon copy rule by its unique ID.

Endpoint

GET /v2/carboncopies/{id}

Path Parameters

Parameter	Type	Required	Description
id	integer	Yes	Unique identifier of the carbon copy rule

Response

Returns the carbon copy rule details including source and destination mailboxes, direction, and status.

{
  "success": true,
  "data": {
    "ccId": 1042,
    "fromMailboxId": 101,
    "toMailboxId": 202,
    "status": "Active",
    "direction": "InBox",
    "created": "2025-01-15T10:30:00Z"
  }
}

ENUMs

This endpoint returns values from the Direction and Status ENUMs. See ENUMs Reference for all valid values.

Code Examples

cURL

curl -X GET "https://rest.ecgrid.io/v2/carboncopies/$ID" \
  -H "X-API-Key: $ECGRID_API_KEY"

C#

// .NET 10 — Retrieve a carbon copy rule by ID
using var response = await httpClient.GetAsync($"https://rest.ecgrid.io/v2/carboncopies/{ccId}");
response.EnsureSuccessStatusCode();

var result = await response.Content.ReadFromJsonAsync<ApiResponse<CarbonCopyInfo>>();
Console.WriteLine($"CC Rule {result.Data.CcId}: {result.Data.Direction} from mailbox {result.Data.FromMailboxId} to {result.Data.ToMailboxId}");

Java

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

String apiKey = System.getenv("ECGRID_API_KEY");
String id = "0"; // replace with actual id

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(String.format("https://rest.ecgrid.io/v2/carboncopies/%s", id)))
    .header("X-API-Key", apiKey)
    .GET()
    .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/carboncopies/${id}`;

const response = await fetch(url, {
  method: 'GET',
  headers: { 'X-API-Key': apiKey },
});

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}
id = 0  # replace with actual id
url = f"https://rest.ecgrid.io/v2/carboncopies/{id}"

response = requests.get(url, headers=headers)

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

See Also

• Create Carbon Copy
• List Carbon Copies
• Update Carbon Copy
• Delete Carbon Copy
• ENUMs Reference