---
title: "List DFW civic-data research coverage"
method: GET
path: "/api/v1/public/coverage"
tags: ["Research coverage"]
---

# List DFW civic-data research coverage

`GET /api/v1/public/coverage`

## Request

- Base URL: `https://aicdapi.com`
- URL: `https://aicdapi.com/api/v1/public/coverage`
- Auth: none required

Returns dated source-discovery evidence for 238 active municipalities and 16 counties in the NCTCOG region. Inactive Mustang is omitted unless `includeInactive=true`. M/D/P/R/U/N statuses apply only to the named data subtype. They do not prove full-family coverage, current completeness, reuse permission or production ingestion. Cursors are bound to the catalog version and all filters.

## Query parameters

- `jurisdictionSlug` string
- `county` 'collin' | 'dallas' | 'denton' | 'ellis' | 'erath' | 'hood' | 'hunt' | 'johnson' | 'kaufman' | 'navarro' | 'palo-pinto' | 'parker' | 'rockwall' | 'somervell' | 'tarrant' | 'wise'
- `family` 'city.permits' | 'city.planning_gis' | 'city.laws_governance' | 'city.finance' | 'city.procurement' | 'city.service_code' | 'city.public_safety' | 'city.health_licenses' | 'city.infrastructure' | 'city.elections_notices' | 'county.property_tax' | 'county.land_records' | 'county.courts' | 'county.procurement' | 'county.finance' | 'county.elections' | 'county.development' | 'county.gis_infrastructure' | 'county.public_safety' | 'county.health_environment' | 'county.government_records'
- `includeInactive` boolean
- `limit` integer
- `cursor` string

## Response `200`

Dated research evidence and gaps. This is not an ingestion-health response.

- ResearchCoverageEnvelope
  - `data` union[], required
    - union
      - CityResearchCoverage
        - `kind` 'city', required
        - `researchId` string, required
        - `jurisdictionSlug` string, required
        - `name` string, required
        - `active` boolean, required
        - `municipalityType` 'city' | 'town' | 'village', required
        - `censusPlaceGeoid` string, required
        - `counties` string[], required
        - `regionCounties` string[], required
        - `primaryRegionCounty` string, required
        - `censusStatus` object, required
          - `functionalStatus` string, required
          - `placeClass` string, required
          - `vintage` string, date, required
        - `sourceUrls` ResearchSourceUrls, required
          - `official` string, uri, nullable, required
          - `openData` string, uri, nullable, required
          - `websiteDiscovery` string, uri, nullable, required
          - `roster` string, uri, required
          - `censusStatus` string, uri, required
          - `countyMembership` string, uri, required
        - `rosterLimits` object, required
          - `boundaryYear` string, required
          - `boundarySource` string, required
          - `directoryListed` boolean, required
          - `websiteVerification` string, required
          - `verificationNotes` string[], required
        - `families` ResearchCoverageFamily[], required
          - `familyId` 'city.permits' | 'city.planning_gis' | 'city.laws_governance' | 'city.finance' | 'city.procurement' | 'city.service_code' | 'city.public_safety' | 'city.health_licenses' | 'city.infrastructure' | 'city.elections_notices' | 'county.property_tax' | 'county.land_records' | 'county.courts' | 'county.procurement' | 'county.finance' | 'county.elections' | 'county.development' | 'county.gis_infrastructure' | 'county.public_safety' | 'county.health_environment' | 'county.government_records', required
          - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N', required: Dated evidence level, not production ingestion status.
          - `evidenceScope` 'named_subtype_only' | 'source_discovery_only' | 'access_or_reuse_restriction' | 'unresolved' | 'not_applicable', required
          - `checkedDate` string, date, required
          - `sourceUrl` string, uri, nullable, required
          - `method` string, required
          - `evidence` string, required
          - `constraints` string, required
          - `alternatives` ResearchCoverageAlternative[], required
            - `title` string
            - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N': Dated evidence level, not production ingestion status.
            - `sourceUrl` string, uri, required
            - `checkedDate` string, date
            - `method` string
            - `evidence` string
            - `constraints` string
          - `subtype` string
          - `subtypes` ResearchCoverageSubtype[]
            - `type` string, required
            - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N', required: Dated evidence level, not production ingestion status.
            - `reason` string, required
            - `url` string, uri
          - `coverageStart` string, date
          - `coverageEnd` string, date
          - `recordCount` integer
          - `coverageQueryUrl` string, uri
          - `countQueryUrl` string, uri
          - `liveSourceFollowup` string
          - `freshness` ResearchCoverageFreshness
            - `note` string
            - `latestOpenedSample` string, date-time
            - `latestFilingSample` string, date-time
            - `latestSampleRecord` string
            - `sourceHistoryClaim` string
            - `futureStatusAnomaly` string, date-time
            - `fullHistoryVerified` boolean
          - `custodian` string
          - `history` string
          - `cost` string
          - `updateFrequency` string
          - `familyConstraints` string
      - CountyResearchCoverage
        - `kind` 'county', required
        - `researchId` string, required
        - `jurisdictionSlug` string, required
        - `countySlug` 'collin' | 'dallas' | 'denton' | 'ellis' | 'erath' | 'hood' | 'hunt' | 'johnson' | 'kaufman' | 'navarro' | 'palo-pinto' | 'parker' | 'rockwall' | 'somervell' | 'tarrant' | 'wise', required
        - `name` string, required
        - `active` true, required
        - `sourceUrls` object, required
          - `roster` string, uri, required
        - `families` ResearchCoverageFamily[], required
          - `familyId` 'city.permits' | 'city.planning_gis' | 'city.laws_governance' | 'city.finance' | 'city.procurement' | 'city.service_code' | 'city.public_safety' | 'city.health_licenses' | 'city.infrastructure' | 'city.elections_notices' | 'county.property_tax' | 'county.land_records' | 'county.courts' | 'county.procurement' | 'county.finance' | 'county.elections' | 'county.development' | 'county.gis_infrastructure' | 'county.public_safety' | 'county.health_environment' | 'county.government_records', required
          - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N', required: Dated evidence level, not production ingestion status.
          - `evidenceScope` 'named_subtype_only' | 'source_discovery_only' | 'access_or_reuse_restriction' | 'unresolved' | 'not_applicable', required
          - `checkedDate` string, date, required
          - `sourceUrl` string, uri, nullable, required
          - `method` string, required
          - `evidence` string, required
          - `constraints` string, required
          - `alternatives` ResearchCoverageAlternative[], required
            - `title` string
            - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N': Dated evidence level, not production ingestion status.
            - `sourceUrl` string, uri, required
            - `checkedDate` string, date
            - `method` string
            - `evidence` string
            - `constraints` string
          - `subtype` string
          - `subtypes` ResearchCoverageSubtype[]
            - `type` string, required
            - `status` 'M' | 'D' | 'P' | 'R' | 'U' | 'N', required: Dated evidence level, not production ingestion status.
            - `reason` string, required
            - `url` string, uri
          - `coverageStart` string, date
          - `coverageEnd` string, date
          - `recordCount` integer
          - `coverageQueryUrl` string, uri
          - `countQueryUrl` string, uri
          - `liveSourceFollowup` string
          - `freshness` ResearchCoverageFreshness
            - `note` string
            - `latestOpenedSample` string, date-time
            - `latestFilingSample` string, date-time
            - `latestSampleRecord` string
            - `sourceHistoryClaim` string
            - `futureStatusAnomaly` string, date-time
            - `fullHistoryVerified` boolean
          - `custodian` string
          - `history` string
          - `cost` string
          - `updateFrequency` string
          - `familyConstraints` string
  - `meta` object, required
    - `catalogVersion` string, required
    - `researchDate` string, date, required
    - `ingestionVerified` false, required
    - `statusDefinitions` object, required
      - `M` string, required
      - `D` string, required
      - `P` string, required
      - `R` string, required
      - `U` string, required
      - `N` string, required
    - `scope` object, required
      - `name` 'NCTCOG 16-county region', required
      - `counties` string[], required
      - `rosterCheckedDate` string, date, required
      - `censusStatusVintage` string, date, required
      - `method` string, required
      - `caveat` string, required
    - `pagination` object, required
      - `limit` integer, required
      - `returned` integer, required
      - `nextCursor` string, nullable, required

## Other responses

- `400`: A path or query parameter is invalid or unsupported.
- `429`: More than 120 requests were made by this client IP in 60 seconds.
- `500`: The request could not be completed because of an internal error.

---

[API](https://skmtc.dev/aicdapi/apis/aicd-api.md) · [All operations](https://skmtc.dev/aicdapi/apis/aicd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicdapi/apis/aicd-api/revisions/0f3752fae465?raw)