Bill Tracking API Quick Reference

Essential Information

Item	Value
Base URL	https://engagifii-billtracking.azurewebsites.net
API Version	1.0
Auth Headers	api-version: 1.0 tenant-code: YOUR_TENANT_CODE
Content Type	application/json
Rate Limit	1000 req/hour, 100 req/min

Quick Authentication

# All requests require these headers:
curl -X GET "https://engagifii-billtracking.azurewebsites.net/api/1.0/endpoint" \
  -H "api-version: 1.0" \
  -H "tenant-code: YOUR_TENANT_CODE" \
  -H "Content-Type: application/json"

Common Endpoints

Reference Data (GET)

/api/1.0/dropdown/states         # Get all states
/api/1.0/dropdown/sessions       # Get sessions
/api/1.0/dropdown/committees     # Get committees  
/api/1.0/dropdown/billtypes      # Get bill types
/api/1.0/dropdown/users          # Get users

Activity Logging (POST)

/api/1.0/activity/log/save       # Save activity log
/api/1.0/activity/log/list       # List activity logs

Bill Events (POST)

/api/1.0/bill/event/calendar     # Get calendar events
/api/1.0/bill/event/calendar/count # Get event count
/api/1.0/bill/event/subscribe    # Subscribe to events

Advocacy (Mixed)

GET  /api/1.0/Advocacy/getChampaignTemplate/{id}
POST /api/1.0/Advocacy/saveChampaignTemplate
POST /api/1.0/Advocacy/list
DELETE /api/1.0/Advocacy/ChampaignTemplate/{id}

Capitol Reports

GET  /api/1.0/CapitolReport/get-legislationDays/{stateId}
POST /api/1.0/CapitolReport/save-legislationDays/{stateId}
POST /api/1.0/CapitolReport/save-report/{stateId}

Common Request Bodies

Activity Log

{
  "userId": "user123",
  "action": "VIEW_BILL",
  "entityType": "BILL",
  "entityId": "12345",
  "timestamp": "2025-01-28T10:30:00Z"
}

Calendar Filter

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "stateIds": [1, 2, 3],
  "pageNumber": 1,
  "pageSize": 50
}

Pagination

{
  "pageNumber": 1,
  "pageSize": 50,
  "sortBy": "fieldName",
  "isAscending": false
}

Response Formats

Success Response

{
  "data": {...},
  "success": true,
  "message": "Operation successful"
}

Paginated Response

{
  "collection": [...],
  "pagingModel": {
    "pageNumber": 1,
    "pageSize": 50,
    "totalRecords": 500,
    "totalPages": 10
  }
}

Error Response

{
  "error": "ErrorType",
  "message": "Error description",
  "details": {
    "code": "ERROR_CODE",
    "timestamp": "2025-01-28T10:30:00Z"
  }
}

HTTP Status Codes

Code	Meaning	Action Required
200	Success	None
400	Bad Request	Fix request data
401	Unauthorized	Check headers
403	Forbidden	Check permissions
404	Not Found	Verify resource ID
429	Rate Limited	Wait and retry
500	Server Error	Retry with backoff

Rate Limit Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1706441400
Retry-After: 60

Quick Examples

Get States (JavaScript)

fetch('https://engagifii-billtracking.azurewebsites.net/api/1.0/dropdown/states', {
  headers: {
    'api-version': '1.0',
    'tenant-code': 'YOUR_TENANT_CODE',
    'Content-Type': 'application/json'
  }
})
.then(res => res.json())
.then(data => console.log(data));

Save Activity Log (Python)

import requests

response = requests.post(
    'https://engagifii-billtracking.azurewebsites.net/api/1.0/activity/log/save',
    headers={
        'api-version': '1.0',
        'tenant-code': 'YOUR_TENANT_CODE',
        'Content-Type': 'application/json'
    },
    json={
        'userId': 'user123',
        'action': 'VIEW_BILL',
        'entityType': 'BILL',
        'entityId': '12345'
    }
)

Get Calendar Events (cURL)

curl -X POST "https://engagifii-billtracking.azurewebsites.net/api/1.0/bill/event/calendar" \
  -H "api-version: 1.0" \
  -H "tenant-code: YOUR_TENANT_CODE" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2025-01-01",
    "endDate": "2025-01-31",
    "stateIds": [1, 2, 3]
  }'

Retry Strategy

// Exponential backoff example
async function retryRequest(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429 || error.status >= 500) {
        const delay = Math.pow(2, i) * 1000;
        await new Promise(r => setTimeout(r, delay));
      } else {
        throw error;
      }
    }
  }
}

Common Filters

Date Range

{
  "startDate": "YYYY-MM-DD",
  "endDate": "YYYY-MM-DD"
}

Multi-Select IDs

{
  "stateIds": [1, 2, 3],
  "sessionIds": [10, 20],
  "committeeIds": [100, 200]
}

Text Search

{
  "text": "search term",
  "searchFields": ["title", "summary"]
}

Enumerations

Event Types

• HEARING
• VOTE
• COMMITTEE_MEETING
• FLOOR_SESSION

Report Types

• 1 - Summary
• 2 - Detailed
• 3 - Executive
• 4 - Weekly
• 5 - Monthly
• 6 - End of Session

Tracking Status

• NOT_TRACKED
• TRACKING
• WATCHING
• PRIORITY
• ARCHIVED

Bill Position

• SUPPORT
• OPPOSE
• NEUTRAL
• MONITOR
• NO_POSITION

Troubleshooting Checklist

• [ ] Both required headers present?
• [ ] Tenant code is correct?
• [ ] API version is 1.0?
• [ ] Content-Type is application/json?
• [ ] Request body is valid JSON?
• [ ] Date format is YYYY-MM-DD?
• [ ] Using HTTPS not HTTP?
• [ ] Within rate limits?

Support Contacts

• Email: api-support@engagifii.com
• Documentation: Full Docs
• Status Page: https://status.engagifii.com

---

Last Updated: January 2025 | Version 1.0