---
title: "Get all flags (All Sections tab)"
method: GET
path: "/flags"
tags: ["Flag"]
---

# Get all flags (All Sections tab)

`GET /flags`

Returns a paginated, tenant-scoped list of flags across all record types. Equivalent to the All Sections tab on the flags landing page. Common columns only — no metaData block. Client (non-certifyos.com) users are restricted to Open flags by default.

## Query parameters

- `endAtId` string
- `filter` string
- `order` string
- `page` integer
- `recordType` string[]
- `sanctionType` string[]
- `size` 10 | 25 | 50 | 100
- `startAfterId` string

## Headers

- `tenant-id` string, required

## Response `200`

Successfully retrieved flags

- GetFlagsResponse — Paginated list of flag rows for the flags landing page
  - `totalCount` integer — Total number of flags matching the query
  - `data` GetFlagResponse[] — Flag rows for the current page
    - `id` string — Flag identifier
    - `recordType` string — Flag record type (tab discriminator)
    - `flagType` string — Flag type identifier (flag_type_id slug)
    - `status` string — Flag lifecycle status
    - `flaggedDate` string — Date the source entity was flagged (ISO-8601)
    - `updatedOn` string — Timestamp of the most recent monitoring source refresh
    - `dataSource` string — Data source identifier
    - `practitioner` PractitionerInfo — Practitioner identity fields denormalized onto the flag row
      - `prefix` string — Name prefix, e.g. Dr.
      - `firstName` string — First name
      - `middleName` string — Middle name
      - `lastName` string — Last name
      - `npi` string — NPI (top-level practitioner NPI, not metaData)
      - `providerType` string[] — Provider/practitioner types (multi-value)
      - `statesToCredential` string[] — States the practitioner is credentialed in
      - `credentialingStatus` string — Credentialing status
      - `dateOfBirth` string — Date of birth (ISO date)
      - `email` string — Primary email
      - `lastCredentialedDate` string — Last credentialed date (ISO date)
    - `createdAt` string — Flag creation timestamp (ISO-8601)
    - `markedSeenAt` string — When the flag was last marked seen (ISO-8601); null when never seen
    - `markedSeenBy` string — Who last marked the flag seen (display name; raw id when unresolvable)
    - `originMonitoringWorkflowId` string — Origin monitoring workflow id (drawer View All Flags link)
    - `metaData` union — Tab-specific metadata fields; absent for All Sections
      - StateLicensesFlagMetaData — metaData returned on state-licenses flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `expiration` unknown
        - `flaggedDate` unknown
        - `issueDate` unknown
        - `licenseNumber` unknown
        - `licenseSource` unknown
        - `licenseStatus` unknown
        - `licenseType` unknown
        - `message` unknown
        - `practitionerType` unknown
        - `sourceUpdateDate` unknown
        - `state` unknown
      - DeaDataFlagMetaData — metaData returned on dea-data flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `expirationDate` unknown
        - `flaggedDate` unknown
        - `message` unknown
        - `number` unknown
        - `schedules` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `state` unknown
        - `status` unknown
      - CdsDataFlagMetaData — metaData returned on cds-data flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `expirationDate` unknown
        - `flaggedDate` unknown
        - `message` unknown
        - `number` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `state` unknown
        - `status` unknown
      - BoardCertificationsFlagMetaData — metaData returned on board-certifications flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `abmsId` unknown
        - `certificateId` unknown
        - `certificateType` unknown
        - `city` unknown
        - `country` unknown
        - `durationType` unknown
        - `expirationDate` unknown
        - `flaggedDate` unknown
        - `issueDate` unknown
        - `message` unknown
        - `moc` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `speciality` unknown
        - `state` unknown
        - `status` unknown
        - `subspeciality` unknown
        - `zipCode` unknown
      - MalpracticeInsurancesFlagMetaData — metaData returned on malpractice-insurances flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `aggregateCoverageAmount` unknown
        - `carrierName` unknown
        - `effectiveDate` unknown
        - `expiryDate` unknown
        - `flaggedDate` unknown
        - `message` unknown
        - `occuranceCoverageAmount` unknown
        - `policyNumber` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `status` unknown
        - `unlimitedCoverage` unknown
      - NpdbDataFlagMetaData — metaData returned on npdb-data flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `certification` unknown
        - `data` unknown
        - `databankSubjectId` unknown
        - `dcn` unknown
        - `deceased` unknown
        - `enrollmentStatus` unknown
        - `firstName` unknown
        - `flaggedDate` unknown
        - `gender` unknown
        - `homeAddress` unknown
        - `homeCity` unknown
        - `homeState` unknown
        - `homeZip` unknown
        - `lastName` unknown
        - `licensureField` unknown
        - `maintainedUnder` unknown
        - `message` unknown
        - `notes` unknown
        - `npi` unknown
        - `otherName` unknown
        - `previousDCN` unknown
        - `previousTransaction` unknown
        - `processDate` unknown
        - `recentChangeDate` unknown
        - `reportDCN` unknown
        - `reportDate` unknown
        - `reportType` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `submitter` unknown
        - `transactionType` unknown
        - `transactionTypeCode` unknown
        - `typeOfAction` unknown
      - LicensureActionsFlagMetaData — metaData returned on licensure-actions flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `actionType` unknown
        - `createdAt` unknown
        - `createdBy` unknown
        - `credWorkflowRecordOrigin` unknown
        - `details` unknown
        - `flaggedDate` unknown
        - `lastActionDate` unknown
        - `licenseNumber` unknown
        - `message` unknown
        - `reportDate` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `state` unknown
        - `updatedAt` unknown
        - `updatedBy` unknown
        - `verifiedBy` unknown
        - `verifiedDate` unknown
      - SanctionsFlagMetaData — metaData returned on sanctions flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `attachments` object[]
          - `createdAt` unknown
          - `createdBy` unknown
          - `expirationDate` unknown
          - `fileType` unknown
          - `fileUrl` unknown
          - `originalFileName` unknown
        - `createdAt` unknown
        - `createdBy` unknown
        - `credWorkflowRecordOrigin` unknown
        - `data` unknown
        - `dateOfReport` unknown
        - `flaggedDate` unknown
        - `message` unknown
        - `parsedData` object
          - `OfacType` unknown
          - `actionOrReason` unknown
          - `activeDate` unknown
          - `additionalComments` unknown
          - `address1` unknown
          - `address2` unknown
          - `address3` unknown
          - `address4` unknown
          - `addresses` unknown
          - `alternateDob` unknown
          - `alternateName` unknown
          - `alternateNumber` unknown
          - `alternateRemarks` unknown
          - `alternateType` unknown
          - `blankDeprecated` unknown
          - `businessName` unknown
          - `cage` unknown
          - `callSign` unknown
          - `city` unknown
          - `classification` unknown
          - `clmRejectDate` unknown
          - `comments` unknown
          - `country` unknown
          - `creationDate` unknown
          - `crossReference` unknown
          - `crosswalk_id` unknown
          - `ctCode` unknown
          - `dataAcquireDate` unknown
          - `dataIssuingSource` unknown
          - `dataSourceUrl` unknown
          - `dob` unknown
          - `effectiveDate` unknown
          - `ein` unknown
          - `eligibleToOrderAndRefer` unknown
          - `entNumber` unknown
          - `exclDate` unknown
          - `excludingAgency` unknown
          - `exclusionDate` unknown
          - `exclusionInitiatedBy` unknown
          - `exclusionProgram` unknown
          - `exclusionType` unknown
          - `firstName` unknown
          - `fullName` unknown
          - `general` unknown
          - `grt` unknown
          - `lastName` unknown
          - `lastUpdated` unknown
          - `licenseNumber` unknown
          - `licenseType` unknown
          - `middleName` unknown
          - `npi` unknown
          - `npi_attribution_source` unknown
          - `openDataFlag` unknown
          - `optoutEffectiveDate` unknown
          - `optoutEndDate` unknown
          - `orgId` unknown
          - `orgName` unknown
          - `preclusions_data` unknown
          - `prefix` unknown
          - `program` unknown
          - `recordStatus` unknown
          - `reinDate` unknown
          - `reincarnationDate` unknown
          - `remarks` unknown
          - `samNumber` unknown
          - `sanctionEndDate` unknown
          - `sanctionType` unknown
          - `sdnName` unknown
          - `sdnType` unknown
          - `sourceUpdateDate` unknown
          - `specialty` unknown
          - `state` unknown
          - `suffix` unknown
          - `terminationDate` unknown
          - `title` unknown
          - `tonnage` unknown
          - `uniqueEntityId` unknown
          - `upin` unknown
          - `vesselFlag` unknown
          - `vesselOwner` unknown
          - `vesselType` unknown
          - `waiverDate` unknown
          - `waiverState` unknown
          - `zipCode` unknown
        - `sanctionStartDate` unknown
        - `sanctionType` unknown
        - `source` unknown
        - `sourceUpdateDate` unknown
        - `typeOfAction` unknown
        - `updatedAt` unknown
        - `updatedBy` unknown
        - `verifiedBy` unknown
        - `verifiedByName` unknown
        - `verifiedDate` unknown
      - NppesFlagMetaData — metaData returned on nppes flag rows. Generated from the FlagResponseSerializer allowlist for this record type: every key not listed here is stripped from the response, hence additionalProperties: false. Property types are unconstrained because the allowlist declares names only.
        - `active` unknown
        - `enumerationType` unknown
        - `firstName` unknown
        - `flaggedDate` unknown
        - `lastName` unknown
        - `message` unknown
        - `middleName` unknown
        - `npi` unknown
        - `organizationId` unknown
        - `sourceUpdateDate` unknown
        - `status` unknown

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized — authentication required
- `403` — Forbidden — missing required permission
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)