Pull GL & payroll reports (Global Payroll)

Pull Remote's balanced, account-mapped Global Payroll General Ledger into your ERP or GL system — via the Remote API, the Remote MCP, in-app download, or NetSuite auto-push.

Who this is for

• Finance and accounting teams reconciling Global Payroll into an ERP or GL.
• Engineers building a payroll-to-GL integration.

What you'll do

Request the GL report for a completed payroll run, poll until it's ready, then download it — the same balanced, account-mapped data you could previously only get via MCP, in-app download, or NetSuite push.

How this is different

The GL is one dataset: balanced and mapped to your accounts. The API, the MCP, the in-app download, and the NetSuite push are all just ways to get at it. The difference is only how you fetch it — the API is the only unattended, programmatic path.

How it works

1. A payroll run completes.
2. Request the report — POST /v1/payroll-runs/{payroll_run_id}/gl-reports with {"type": "summary" | "by_department" | "employee_detail"}. Returns a report resource with status: pending.
3. Poll — GET /v1/payroll-runs/{payroll_run_id}/gl-reports/{gl_report_id} until status is completed or failed.
4. Download — GET /v1/payroll-runs/{payroll_run_id}/gl-reports/{gl_report_id}/download returns the finished report as CSV.

Good to know

• The GL is balanced and account-mapped by Remote before you receive it, whichever surface you use.
• No legal_entity_id scoping. If a payroll run spans multiple legal entities, that breakdown shows up within the report content (department/cost-center dimensions), not as a request-level filter.
• Generation isn't instant — reports run through a pipeline, so the API is request → poll → download, not a single synchronous call.

Other ways to get the GL

Ask the Remote MCP

The Remote MCP can answer GL questions directly — good for spot checks and letting an agent read the ledger on your behalf, without polling.

Download in-app

The manual path for a full, balanced export (confirm exact in-app location before documenting it internally).

NetSuite auto-push

If you're on NetSuite, Remote can auto-push the GL so it lands there without a manual export step (confirm setup steps and prerequisites).

For AI agents

• Point agents at the API Reference for the live flow: request the report for a completed payroll run → poll for completion → download → hand to the accounting workflow.
• The Remote MCP remains the quickest path for ad hoc GL questions and spot checks.
• A machine-readable index of these docs is published at /llms-full.txt (confirm public base URL before publish).

Next steps

• Use the live API for scheduled, unattended GL pulls.
• Use the Remote MCP for ad hoc GL questions and reconciliation spot checks.
• Set up NetSuite auto-push if you're on NetSuite, or use in-app download otherwise.