Integrations > SyncRun

Reads all Sync runs

Changed on

Reads all Sync runs

get/api/2026-10-01/resources/integrations/sync_runs

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/integrations/sync_runs
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token
    • or API key in header x-api-key

Query parameters

ids[]string[]

identifier of sync run

marketplace_integration_uuidstring required

UUID of the marketplace integration to filter sync runs by.

Example:123e4567-e89b-12d3-a456-426614174000
created_at_gteqstring required

Filter sync runs by their creation timestamp (created_at), on or after this timestamp (inclusive).

Example:2026-07-01T00:00:00.000Z

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "status": "succeeded",
      "started_at": "2026-07-01T18:05:45.000Z",
      "finished_at": "2026-07-01T18:10:12.000Z",
      "context": {
        "from": "2026-01-01",
        "to": "2026-01-31"
      },
      "company_id": "1",
      "integration_uuid": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Changes