Legislative Tracking API Documentation

Overview

The Legislative Tracking API is a comprehensive RESTful service designed for legislative tracking and management. This API enables external developers to integrate powerful Legislative Tracking capabilities, legislative monitoring, and advocacy management features into their applications.

Quick Start Guide

Get up and running with the Legislative Tracking API in under 5 minutes:

1. Obtain API Credentials: Contact our support team to get your tenant-code
2. Set Required Headers: Include api-version and tenant-code in all requests
3. Make Your First Call: Test connectivity with a simple dropdown endpoint
4. Explore Features: Use our comprehensive endpoints for Legislative Tracking and reporting

Example First Request

curl -X GET "https://engagifii-billtracking.azurewebsites.net/api/1.0/dropdown/states" \
  -H "api-version: 1.0" \
  -H "tenant-code: YOUR_TENANT_CODE" \
  -H "Content-Type: application/json"

Base URLs

Environment	URL
Production	https://engagifii-billtracking.azurewebsites.net
Staging	Contact support for staging environment access
Development	Contact support for development environment access

API Version

• Current Version: 1.0
• Version Strategy: URL path versioning (/api/{api-version}/)
• Backward Compatibility: Previous versions maintained for 12 months after deprecation

Key Features

Legislative Tracking

• Real-time bill monitoring across multiple states
• Committee tracking and legislative calendar management
• Public official information and voting records
• Legislative session synchronization

Reporting & Analytics

• Capitol reports generation
• Custom bill report creation
• Historical data analysis
• Export capabilities in multiple formats

Advocacy Management

• Campaign template management
• Stakeholder engagement tracking
• Activity logging and audit trails

Data Management

• Comprehensive dropdown data for UI integration
• Batch data synchronization
• File upload and management
• Multi-tenant architecture support

Documentation Structure

Document	Description
Getting Started	Complete onboarding guide with prerequisites and first API call
Authentication	Security implementation, token management, and best practices
API Reference	Complete endpoint documentation with examples
Data Models	Schema definitions for all request/response objects
Error Handling	Error codes, troubleshooting, and retry strategies
Quick Reference	One-page cheat sheet for common operations
Changelog	Version history and migration guides

Interactive Tools

• OpenAPI Specification: Machine-readable API definition
• Postman Collection: Import directly into Postman for testing
• Integration Examples: Sample code in multiple languages

API Capabilities Summary

Core Endpoints

Category	Primary Use Case
/bill/event/	Calendar events and legislative scheduling
/DataSync/	Synchronize bills, sessions, and legislative data
/dropdown/	Reference data for UI dropdowns
/CapitolReport/	Generate and manage legislative reports
/client/	Client and user management
/Advocacy/	Campaign and advocacy tracking

Response Formats

• JSON: Primary response format
• Support for: application/json, application/json-patch+json, text/json

Rate Limiting

• Default: 1000 requests per hour per tenant
• Burst: 100 requests per minute
• Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Support Information

Getting Help

• Email: api-support@engagifii.com
• Developer Portal: https://developers.engagifii.com
• Status Page: https://status.engagifii.com

Reporting Issues

• Include your tenant-code and request ID
• Provide complete error messages and timestamps
• Share minimal reproducible examples

Feature Requests

Submit feature requests through our developer portal or contact your account manager for priority implementations.

Security & Compliance

• Transport Security: All API calls must use HTTPS
• Authentication: Multi-tenant secure authentication required
• Data Privacy: GDPR and CCPA compliant
• Audit Logging: All API calls are logged for security and compliance

Service Level Agreement

• Uptime: 99.9% availability guarantee
• Response Time: < 500ms for 95% of requests
• Support Response:
  • Critical: 1 hour
  • High: 4 hours
  • Normal: 24 hours

Migration from Previous Versions

If you're migrating from a previous API version, please refer to our Changelog for breaking changes and migration guides.

Terms of Service

By using this API, you agree to our Terms of Service. For the complete terms, please visit our legal documentation page.

---

Last Updated: January 2025API Version: 1.0