---
title: "Saved daily schedule, latest daily-run timestamps and state, custom schedules, active jobs and per-connection status. The scheduler remains assigned without a plan, but real connections run only while /me.can_sync is true; sandbox connections are exempt."
method: GET
path: "/api/v2/sync"
---

# Saved daily schedule, latest daily-run timestamps and state, custom schedules, active jobs and per-connection status. The scheduler remains assigned without a plan, but real connections run only while /me.can_sync is true; sandbox connections are exempt.

`GET /api/v2/sync`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/sync`
- Auth: HTTP bearer

## Query parameters

- `workspace_id` string

## Response `200`

Schedule and current sync status.

- object
  - `data` object
    - `schedule` SyncSchedule
      - `type` 'default' | 'custom'
      - `daily_sync_time` string
      - `timezone` string
      - `next_run_at` string, date-time, nullable: Next scheduled daily occurrence. May be overdue until queued; not a guaranteed actual start or completion.
      - `last_daily_sync` DailySyncRun: The latest recorded daily occurrence; timestamps are UTC. Queueing is not starting, and only full successful completion sets finished_at.
        - `state` 'queued' | 'running' | 'finished' | 'failed' | 'skipped', required
        - `scheduled_at` string, date-time, required: Scheduled occurrence, which can precede actual start.
        - `started_at` string, date-time, nullable, required: Actual first bank-worker start, or null if not recorded.
        - `finished_at` string, date-time, nullable, required: Successful completion of all tracked bank sync chains, including exports. Null while incomplete or failed.
        - `failed_at` string, date-time, nullable, required: When failure was recorded.
        - `skipped_at` string, date-time, nullable, required: When a run without eligible accounts was skipped.
      - `last_completed_daily_sync_at` string, date-time, nullable: Most recent successful daily completion, retained while a newer run is queued, running, failed or skipped.
      - `last_sync_at` string, date-time, nullable: Legacy Workspace-job dispatch timestamp, not actual daily start or completion.
      - `next_sync_window` object, nullable
        - `earliest` string, date-time, nullable: Same as next_run_at.
        - `latest` string, date-time, nullable: Same as next_run_at.
      - `custom_schedules` object[]
      - `default_sweep_applies` boolean
    - `active_syncs` object[]
    - `connections` object[]

---

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