> This page is for Referencia de la API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://signalcore.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://signalcore.ai/docs/_mcp/server.

# Get

GET https://signalcore.ai/v1/usage

The usage ledger totalled by kind from `from` (the start of this month, UTC) to `to`
(now): each kind's quantity in its unit, how many were metered, their cost in USD and how
many have no known cost (USAGE.md); all that is priced (`cost`); and `messages` per channel
(`received`, `sent`). The organization's, or the managed one a key names.

Reference: https://signalcore.ai/docs/referencia/uso/get

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `from` (datetime, optional, nullable)
- `to` (datetime, optional, nullable)

## Response

### 200

Successful Response

- `org_id` (string, required)
- `from` (datetime, required)
- `to` (datetime, required)
- `cost` (double, required)
- `used` (list of UsedOut, required)
- `messages` (list of ChannelUsageOut, required)

## Errors

### 422 Usage Get Request Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### UsedOut

- `kind` (string, required)
- `unit` (string, required)
- `quantity` (double, required)
- `count` (integer, required)
- `cost` (double, required)
- `unpriced` (integer, required)

### ChannelUsageOut

- `channel` (enum, required)
  - Allowed values: `whatsapp`, `instagram`, `sms`
- `received` (integer, required)
- `sent` (integer, required)

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)
- `input` (any, optional)
- `ctx` (map from string to any, optional)

### ValidationErrorLocItem

## Examples

**Response**

```json
{
  "org_id": "org_id",
  "from": "2024-01-15T09:30:00Z",
  "to": "2024-01-15T09:30:00Z",
  "cost": 1.1,
  "used": [
    {
      "kind": "kind",
      "unit": "unit",
      "quantity": 1.1,
      "count": 1,
      "cost": 1.1,
      "unpriced": 1
    }
  ],
  "messages": [
    {
      "channel": "whatsapp",
      "received": 1,
      "sent": 1
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://signalcore.ai/v1/usage"

headers = {"Authorization": "Bearer <token>"}

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

print(response.json())
```