**Partner organisations only

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.getpenfold.dev/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Penfold Payroll API v4 MCP server": {
    "url": "https://docs.getpenfold.dev/mcp"
  }
}

GET /employers/{employer_id}/employees/{employee_id}/transactions

O auth2 client credentials

Partner organisations only. A Payroll organisation calling this endpoint receives 405 Method Not Allowed.

Full transaction history for the worker. No pagination. Obsolete or corrected rows are excluded server-side.

Path parameters

employer_id string Required
employee_id string Required

Responses

200 application/json

Transaction history retrieved successfully.
Hide response attributes Show response attributes object
- id string Required
  
  Unique identifier for the transaction.
- amount_pence integer Required
  
  Signed amount in pence. Positive = money in; negative = money out (e.g. transfer out, withdrawal).
- date string(date) Required
  
  Transaction date (YYYY-MM-DD).
- type string Required
  
  Values are Redress, TaxReclaim, Fee, Referral, PersonalContribution, BusinessContribution, Transfer, WorkplacePersonal, WorkplaceEmployer, or Withdrawal.
- status string Required
  
  Values are Pending or Completed.
- frequency string
  
  Values are OneOff or Monthly.
- contribution_type string
  
  Values are NetPay or ReliefAtSource.
- contribution_source string | null
  
  Additional source detail when needed beyond type (e.g. InternalTransferIn).
401 application/json

Unauthorized.
Hide response attribute Show response attribute object
- error string
  
  A descriptive error message.
404 application/json

Employee or employer not found.
Hide response attribute Show response attribute object
- error string
  
  A descriptive error message.
405 application/json

Method not allowed
Hide response attribute Show response attribute object
- error string
  
  A descriptive error message.

GET /employers/{employer_id}/employees/{employee_id}/transactions

curl \
 --request GET 'https://payroll-api.getpenfold.dev/v4/employers/{employer_id}/employees/{employee_id}/transactions' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

[
  {
    "id": "string",
    "amount_pence": 5000,
    "date": "2026-05-04",
    "type": "Redress",
    "status": "Pending",
    "frequency": "OneOff",
    "contribution_type": "NetPay",
    "contribution_source": "string"
  }
]

Response examples (401)

{
  "error": "Bad request: invalid data provided."
}

Response examples (404)

{
  "error": "Bad request: invalid data provided."
}

Response examples (405)

{
  "error": "Bad request: invalid data provided."
}