---
title: "Registrations expiring within N days (Pro)"
method: GET
path: "/api/v1/entities/expiring"
tags: ["Entities"]
---

# Registrations expiring within N days (Pro)

`GET /api/v1/entities/expiring`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/entities/expiring`
- Auth: HTTP bearer

Active SAM registrations expiring within `within_days` days.

Pro. Renewal-radar use case: customers monitor a state, a NAICS
cohort, or the full population for entities that need to renew. Past-due
expirations are excluded (status would already be 'E').

Sorted by expiration_date ascending (most urgent first). Result includes
`days_until_expiration` for direct rendering.

## Query parameters

- `within_days` integer: Days from today to look ahead
- `state` string, nullable
- `naics` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)