# getCountersCount

**Beschreibung:**  
Ruft den Zählerstand eines bestimmten Zählers oder Sensors zu einem angegebenen Zeitpunkt ab.  
Dabei wird der zum angefragten UTC-Zeitpunkt passende verfügbare Zählerwert zurückgegeben.  

**Endpunkt:** `/api`  
**Methode:** `POST`  

#### Parameter:
- `apikey` (string) – API-Schlüssel des Benutzers, aus `getApiKey()`
- `SensorID` (number) – Eindeutige Kennung des Sensors/Zählers, aus `getSensors()` oder `getCounters()`
- `UTC_TIMESTAMP` (number) – Zeitpunkt im UTC-Timestamp-Format, für den der Zählerstand abgefragt werden soll

#### Beispielanfrage:
```json
{
    "action": "getCounterCount",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "SensorID": "551911",
    "UTC_TIMESTAMP": "1739862041"
}
```

#### Beispiel mit cURL:
```powershell
$body = @{
    action = "getCounterCount"
    apikey = "6641d282073d76b625987af5141d3e2a"
    SensorID = "551911"
    UTC_TIMESTAMP = "1739862041"
} | ConvertTo-Json -Compress

Invoke-RestMethod `
    -Uri "https://apiv2.smart-dog.eu/index.php" `
    -Method Post `
    -ContentType "application/json" `
    -Body $body
```

#### Beispielantwort:
```json
{
    "CounterCount": "4592390",
    "TIMESTAMP_UTC": "1739833200.000000"
}
```

#### Beschreibung der Antwortparameter:
- **CounterCount** (string):  
  Zählerstand des angefragten Sensors oder Zählers zum ermittelten Zeitpunkt.

- **TIMESTAMP_UTC** (string):  
  UTC-Zeitstempel des zurückgegebenen Zählerstands.  
  Dieser kann vom angefragten `UTC_TIMESTAMP` abweichen, wenn der nächstpassende verfügbare Messzeitpunkt verwendet wird.

#### Nähere Informationen zu Antwortformat und Fehlermeldungen:
[Antwortformat und Fehler](https://anleitung.smart-dog.eu/books/api-dokumentation/chapter/antwortformat-und-fehler)