// Advanced request with query parameters
const queryParams = new URLSearchParams({
  'PageSize': '10',
  'PageNumber': '1',
  'Sort': 'PeriodName',
  'Filter': 'IsActive eq true'
});

const response = await fetch(`https://localhost:7092/api/calendar-periods?${queryParams.toString()}`, {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
    'x-api-tenantid': 'YOUR_TENANT_ID'
  }
});

if (!response.ok) {
  throw new Error(`HTTP error! status: ${response.status}`);
}

const data = await response.json();
console.log(`Retrieved ${data.data.length} calendar periods`);

# DataStream FYI API Client Class
import requests
import json
from typing import Dict, Optional, Any

class DataStreamApiClient:
    def __init__(self, api_key: str, tenant_id: str, base_url: str = 'https://localhost:7092'):
        self.base_url = base_url.rstrip('/')
        self.session = requests.Session()
        self.session.headers.update({
            'Accept': 'application/json',
            'x-api-key': api_key,
            'x-api-tenantid': tenant_id
        })
    
    def get_calendar_periods(self, page_size: int = 10, page_number: int = 1) -> Dict[str, Any]:
        """Retrieve calendar periods with pagination"""
        params = {
            'PageSize': page_size,
            'PageNumber': page_number
        }
        
        try:
            response = self.session.get(f'{self.base_url}/api/calendar-periods', params=params)
            response.raise_for_status()
            return response.json()
        except requests.exceptions.RequestException as e:
            raise Exception(f"Failed to retrieve calendar periods: {e}")

# Usage
client = DataStreamApiClient('YOUR_API_KEY', 'YOUR_TENANT_ID')
periods = client.get_calendar_periods(page_size=20)
print(f"Found {periods['totalCount']} total periods")

// Strongly-typed DataStream FYI API client
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class CalendarPeriod
{
    public string PeriodId { get; set; }
    public string PeriodName { get; set; }
    public DateTime StartDate { get; set; }
    public DateTime EndDate { get; set; }
    public bool IsActive { get; set; }
}

public class ApiResponse
{
    public List Data { get; set; }
    public int TotalCount { get; set; }
    public int PageSize { get; set; }
    public int PageNumber { get; set; }
}

public class TypedDataStreamApiClient : IDisposable
{
    private readonly HttpClient _httpClient;
    private const string BaseUrl = "https://localhost:7092";

    public TypedDataStreamApiClient(string apiKey, string tenantId)
    {
        _httpClient = new HttpClient();
        _httpClient.DefaultRequestHeaders.Add("x-api-key", apiKey);
        _httpClient.DefaultRequestHeaders.Add("x-api-tenantid", tenantId);
        _httpClient.DefaultRequestHeaders.Add("Accept", "application/json");
    }

    public async Task> GetCalendarPeriodsAsync(int pageSize = 10, int pageNumber = 1)
    {
        try
        {
            var url = $"{BaseUrl}/api/calendar-periods?PageSize={pageSize}&PageNumber={pageNumber}";
            var response = await _httpClient.GetAsync(url);
            
            response.EnsureSuccessStatusCode();
            
            var jsonContent = await response.Content.ReadAsStringAsync();
            return JsonConvert.DeserializeObject>(jsonContent);
        }
        catch (HttpRequestException ex)
        {
            throw new Exception($"Error calling API: {ex.Message}", ex);
        }
    }

    public void Dispose()
    {
        _httpClient?.Dispose();
    }
}

// Usage
using var client = new TypedDataStreamApiClient("YOUR_API_KEY", "YOUR_TENANT_ID");
var response = await client.GetCalendarPeriodsAsync(pageSize: 20);
Console.WriteLine($"Found {response.TotalCount} total periods, showing {response.Data.Count}");