---
title: "List export jobs for the Activity Center"
method: GET
path: "/directory/exports"
tags: ["Directory"]
---

# List export jobs for the Activity Center

`GET /directory/exports`

Retrieves a paginated list of asynchronous directory export jobs for a tenant, for the
Activity Center feature. Results can be filtered by export type (practitioner, facility,
or group), job status, and job type (MANUAL or SCHEDULED).

## Query parameters

- `initiated_by` string
- `job_type` string
- `page_offset` integer
- `page_size` integer
- `search` string
- `status` string
- `status_not_in` string
- `tenant_id` string, required
- `type` string

## Headers

- `tenant-id` string

## Response `200`

Export jobs retrieved successfully

- EgressJobListResponse — Paginated list of export jobs for the Activity Center
  - `jobs` EgressJobSummaryDto[] — Export job summaries for the current page
    - `tableName` string — Spanner table name
    - `correlationId` string — Correlation ID for the export job
    - `type` string — Export type
    - `tenantId` string — Tenant ID
    - `templateId` string — Template ID used for the export, if any
    - `templateName` string — Template name used for the export, if any. Currently always null pending DAL support for including the template name in this endpoint's response (CP-35412 follow-up).
    - `jobType` 'MANUAL' | 'SCHEDULED' — Job type
    - `status` string — Current status of the export job
    - `expectedRows` integer — Expected number of rows for the export
    - `successfulRows` integer — Number of rows successfully exported
    - `unsuccessfulRows` integer — Number of rows that failed to export
    - `initiatedByUserId` string — User ID that initiated the export job
    - `createdAt` string — Timestamp the export job was created
    - `updatedAt` string — Timestamp the export job was last updated
    - `cancelledAt` string — Timestamp the export job was cancelled, if applicable
    - `cancelledByUserId` string — User ID that requested cancellation, if applicable
    - `startedAt` string — Timestamp the export job started. Derived alias for createdAt (the DAL does not track a distinct start time separate from job creation).
    - `finishedAt` string — Timestamp the export job finished (reached a terminal status). Derived alias for updatedAt once status is COMPLETED/FAILED/CANCELLED; null while still running, since the DAL overwrites updatedAt on every intermediate status change.
  - `pageSize` integer — Page size used for this response
  - `pageOffset` integer — Page offset used for this response
  - `totalCount` integer — Total number of jobs matching the filters

## Other responses

- `400` — Bad Request - tenant_id is required, or page_size/page_offset is invalid
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions or tenant_id does not match the authorized tenant
- `500` — Internal server error
- `503` — Egress service unavailable

---

[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)