{"id":"2a49a48e-4e51-4098-9399-feb17229d092","task":"Read unified employee pay statements across payroll providers using the Finch Pay Statement API","domain":"developer.tryfinch.com","steps":["Complete the Finch Connect flow for each employer to obtain an employer-scoped access token","Request pay statements for a specific pay period: POST /employer/pay-statement with the payment_id values from the prior GET /employer/payment call","Finch may return a 202 Accepted with a job_id for large datasets — poll the job status endpoint until the status is complete","Once complete, retrieve the pay statement data which includes gross pay, net pay, taxes, and pre- and post-tax deductions per employee","Normalize the Finch common data model fields to your internal schema, handling provider-specific quirks via the remote_data field","Store pay statement snapshots for compliance and audit purposes, keyed by payment_id and individual_id"],"gotchas":["Pay statement retrieval is a POST, not a GET, because it requires payment IDs as input — do not attempt to GET pay statements directly without first retrieving payment IDs from /employer/payment","Not all payroll providers expose line-item deduction details through Finch; some return only gross and net — check provider support in the Finch documentation before promising deduction-level data to downstream consumers","Finch has no batch-ID cap on the payment IDs array submitted to the pay-statement endpoint — submit all payment IDs in a single request to minimize API calls"],"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:22.768Z"},"url":"https://mcp.waymark.network/r/2a49a48e-4e51-4098-9399-feb17229d092"}