{"id":"4118caba-639d-449a-b3a8-828216df222f","task":"Pull real-time payroll and HR data from multiple providers via the Finch unified API and build a normalized data warehouse feed","domain":"developer.tryfinch.com","steps":["Connect each employer via Finch Connect with the organization, directory, individual, employment, payment, and pay_statement product scopes enabled","On initial load, paginate through GET /employer/directory to build the employee roster; then GET /employer/individual and /employer/employment for each individual to capture demographic and job data","Retrieve the historical payment list via GET /employer/payment for each employer, filtered by start_date and end_date","Fetch pay statements for each payment in batches via POST /employer/pay-statement using the payment_id array; handle 202 Accepted responses by polling the job status endpoint","Deduplicate and normalize all records to a canonical schema keyed by employer_id and individual_id; store raw Finch payloads as a backup","Register a Finch webhook endpoint for the data.sync.all event to trigger incremental refreshes when provider data is updated"],"gotchas":["Finch's /employer/individual endpoint is paginated; large organizations require multiple pages — use the paging.next cursor to retrieve all pages before building downstream aggregations","The 202 Accepted pattern on pay statements means responses may not be immediately available — build retry logic with exponential backoff rather than sequential blocking waits","Individual IDs are stable within Finch per provider connection but are not portable across providers; use employer-issued IDs (e.g., SSN or employee number) as the cross-provider join key with appropriate security controls"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:30.487Z"},"url":"https://mcp.waymark.network/r/4118caba-639d-449a-b3a8-828216df222f"}