Expiring (Pro)

Active SAM registrations expiring within within_days days. Sorted by urgency (most urgent first). Past-due registrations are excluded (their status is 'E'). The renewal-radar use case: compliance dashboards, renewal-reminder SaaS, BD pipelines flagging at-risk leads.

Parameters

within_days - 1-365, default 60. Days from today to look ahead.
state - 2-character US state code (optional).
naics - 6-digit NAICS code, no suffix (optional). Matches both primary_naics and naics_codes[].
limit - Results per page. Default 100, maximum 1,000. Over the maximum returns 402.
offset - Pagination offset (default 0).

Response

The row array is returned under BOTH results AND data (identical contents). Either key is safe to read.

{
  "query": {"within_days": 30, "state": "DC", "naics": null},
  "pagination": {"limit": 50, "offset": 0, "total": 391, "has_next": true},
  "results": [
    {
      "uei": "...",
      "legal_business_name": "ACME CONSULTING LLC",
      "registration_status": "A",
      "registration_expiration_date": "2026-05-12",
      "days_until_expiration": 12,
      "primary_naics": "541611",
      "business_types": ["27", "2X", "8W"],
      "business_types_labels": [
        "Self Certified Small Disadvantaged Business",
        "For Profit Organization",
        "Women-Owned Small Business (WOSB)"
      ],
      "physical_city": "WASHINGTON",
      "physical_state": "DC",
      "physical_country": "USA"
    }
  ],
  "data": [ "...same rows as results above..." ]
}

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/entities/expiring?within_days=30&state=DC&limit=20"

Errors: 401, 402 (not on Pro), 422 (within_days out of 1-365), 429.

Note: days_until_expiration is computed at request time. Cached responses can drift. Sort is fixed at urgency-ascending.