Paygoro API · v1

Build on your Paygoro workspace

A versioned REST API over the data in your Paygoro workspace — legal entities, bank accounts and balances, transactions, bills and payees. Authenticate with a workspace API key and integrate with the accounting, reporting and payables tools you already run.

Quick start

1. Create an API key. A workspace owner or admin opens Settings → Developers in Paygoro, picks the scopes the integration needs, and copies the key. It starts with pgk_ and is shown only once.
2. Check the connection. Call GET /workspace — it needs no scope and echoes the key's permissions.
3. Read some data. List transactions, then walk the pages with nextCursor.

curl "https://api.paygoro.com/v1/workspace" \
  -H "Authorization: Bearer $PAYGORO_API_KEY"

{
  "id": "acc_3f9c2a7e",
  "name": "Main account",
  "apiKey": {
    "id": "acc_3f9c2a7e",
    "name": "Main account",
    "scopes": [
      "transactions:read",
      "accounts:read"
    ]
  }
}

curl "https://api.paygoro.com/v1/transactions?limit=50" \
  -H "Authorization: Bearer $PAYGORO_API_KEY"

Resources

Everything in v1 hangs off the workspace your key belongs to. A workspace can hold several legal entities (companies); accounts, transactions, bills and payees each belong to one of them, and every list accepts a companyId filter.

Where to next

• Authentication — keys, scopes, rotation.
• Incremental sync — keep an accounting or reporting system current without re-reading everything.
• Errors and rate limits — what to expect when something goes wrong.
• OpenAPI 3.1 document — generate a client or import into Postman, Insomnia or Bruno.

Browse the full reference