# API Documentation for Partner Analytics

## Range

The lookback window. Defaults to `7d`.

### Allowed Values:
- `1d`
- `7d`
- `30d`
- `90d`

## Network

**Required:** CAIP-2 network filter, or the alias `solana-mainnet` / `solana-devnet`.

## Responses

### `200` - Successful Response

Usage rows for the partner, newest window first.

#### Data Structure

```json
{
  "data": [
    {
      "merchantOrganizationId": "string",
      "merchantOrganizationName": "string",
      "endpoint": "https://api.merchant.test/widget",
      "count": 42,
      "volumeUsd": "1234.560000"
    }
  ],
  "meta": {
    "range": "7d",
    "network": "solana-mainnet",
    "partnerOrganizationId": "22222222-2222-4222-8222-222222222222"
  }
}
```

### `400` - Bad Request

Unsupported `range` value, or missing/invalid `network`.

### `403` - Forbidden

Missing or malformed tenant header (staging/production).

## Example Usage

### CURL Example

```shell
curl --request GET \
     --url https://api.figment.io/x402/partner_analytics \
     --header 'accept: application/json' \
     --header 'x-api-key: your-api-key-here'
```

---