Full transaction history for the worker

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 Partner API MCP server": {
    "url": "https://docs.getpenfold.dev/mcp"
  }
}

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

O auth2 client credentials

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."
}