# Retrieve the list of site FHIR mapping state records

Endpoint: GET /site/{siteId}/fhir-mapping-state
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)

## Query parameters:

  - `resourceType` (string)
    Filter by FHIR resource type

  - `fhirId` (string)
    Filter by FHIR ID

  - `ehrResourceId` (string)
    Filter by EHR resource ID

  - `fhirStoreStatus` (string)
    Filter by FHIR store status
    Enum: "UNMAPPED", "MAPPED", "IMPORTED", "ERROR"

  - `page` (number)
    Page number (0-based)

  - `pageSize` (number)
    Number of items per page
    Example: 10

  - `sortBy[0][field]` (string)
    First sort field
    Enum: "id", "resourceType", "ehrResourceName", "subfolder", "isActive", "fhirStoreStatus", "mappedAt", "createdAt", "updatedAt"

  - `sortBy[0][dir]` (string)
    First sort direction
    Enum: "asc", "desc"

  - `sortBy[1][field]` (string)
    Second sort field
    Enum: "id", "resourceType", "ehrResourceName", "subfolder", "isActive", "fhirStoreStatus", "mappedAt", "createdAt", "updatedAt"

  - `sortBy[1][dir]` (string)
    Second sort direction
    Enum: "asc", "desc"

## Response 200 fields (application/json):

  - `data` (array, required)
    Array of Site FHIR mapping state records

  - `data.id` (number, required)
    ID of the FhirMappingState record
    Example: 1

  - `data.siteId` (number, required)
    Site ID this record relates to
    Example: 1

  - `data.resourceType` (string, required)
    Resource type
    Example: "Organization"

  - `data.ehrResourceName` (string, required)
    EHR resource name
    Example: "insurance_carrier"

  - `data.ehrResourceId` (string, required)
    EHR resource ID
    Example: "19000021031362"

  - `data.ehrResourceHash` (string,null)
    EHR resource hash
    Example: "9c973682474c2c7e"

  - `data.subfolder` (string,null)
    Subfolder
    Example: "core"

  - `data.sourceFile` (string,null)
    Source file
    Example: "synchronizer/20/collected/organization/20250731_151154_organization_20_data.json"

  - `data.sourceFileHash` (string,null)
    Source file hash
    Example: "dc4383ab00e078ff"

  - `data.isActive` (boolean,null)
    False when the resource is not active (soft-deleted)
    Example: true

  - `data.fhirId` (string,null)
    FHIR ID
    Example: "db33baca-c28e-4eba-af36-6b69e08dfb93"

  - `data.fhirStoreStatus` (string,null)
    FHIR store status
    Example: "IMPORTED"

  - `data.mappedAt` (string,null)
    Mapped at date
    Example: "2025-08-06 13:58:20.735"

  - `data.createdAt` (string, required)
    Created at date
    Example: "2025-08-06 13:58:23.625"

  - `data.updatedAt` (string, required)
    Updated at date
    Example: "2025-08-06 13:58:23.625"

  - `meta` (object, required)
    Pagination metadata

  - `meta.page` (number, required)
    Current page number (0-based)

  - `meta.pageSize` (number, required)
    Number of items per page
    Example: 10

  - `meta.total` (number, required)
    Total number of items
    Example: 150

  - `meta.totalPages` (number, required)
    Total number of pages
    Example: 15

  - `meta.hasNext` (boolean, required)
    Whether there is a next page
    Example: true

  - `meta.hasPrevious` (boolean, required)
    Whether there is a previous page

## Response 401 fields (application/json):

  - `message` (string, required)
    Error message indicating unauthorized access.
    Example: "Unauthorized"

  - `statusCode` (number, required)
    HTTP status code for unauthorized access.
    Example: 401


## Response 400 fields