Penfold Partner API

List payments

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

mcp.json 
"Penfold Partner API MCP server": {
  "url": "https://docs.getpenfold.dev/mcp"
}
Close
GET /employers/{employerId}/payments
Bearer auth

Returns all bank transfer payments for the specified employer, including past (received) and upcoming (outstanding) payments. Use the status field to distinguish between them.

Path parameters

  • employerId string(uuid) Required

    Penfold employer UUID

Responses

  • 200 application/json

    List of payments

    Hide response attribute Show response attribute object
    • payments array[object] Required
      Hide payments attributes Show payments attributes object
      • id string Required

        Unique identifier for the payment

      • amountPence integer Required

        Total payment amount in pence

      • paymentReference string Required

        Bank transfer reference to use when making the payment. Format: {frequencyPrefix}{yyMMdd}{employerNumber}-{suffix} where frequencyPrefix is M(onthly)/W(eekly)/4(weekly)/2(weekly), date is the pay period start, and employer number is the external reference without the PEN prefix. Max 18 characters.

      • payPeriodStart string(date) Required

        Start date of the pay period this payment covers (ISO 8601 date)

      • payPeriodEnd string(date) Required

        End date of the pay period this payment covers (ISO 8601 date)

      • status string Required

        Whether Penfold has received this payment.

        Values are Outstanding or Received.

      • createdAt string(date-time) Required

        When the payment record was created (ISO 8601)
  • 401 application/json

    Missing or invalid authentication token

    Hide response attribute Show response attribute object
    • error string Required
  • 404 application/json

    Resource not found

    Hide response attribute Show response attribute object
    • error string Required
  • 500 application/json

    Internal server error

    Hide response attribute Show response attribute object
    • error string Required
GET /employers/{employerId}/payments 
curl \
 --request GET 'https://partner-api.getpenfold.com/v4/employers/{employerId}/payments' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "payments": [
    {
      "id": "p1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "amountPence": 850000,
      "paymentReference": "M25030112345678-ZG",
      "payPeriodStart": "2025-03-01",
      "payPeriodEnd": "2025-03-31",
      "status": "Outstanding",
      "createdAt": "2025-03-15T10:00:00Z"
    },
    {
      "id": "p2b3c4d5-e6f7-8901-bcde-f12345678902",
      "amountPence": 920000,
      "paymentReference": "M25020112345678-AB",
      "payPeriodStart": "2025-02-01",
      "payPeriodEnd": "2025-02-28",
      "status": "Received",
      "createdAt": "2025-02-15T10:00:00Z"
    }
  ]
}
Response examples (401) 
{
  "error": "unauthorized"
}
Response examples (404) 
{
  "error": "not found"
}
Response examples (500) 
{
  "error": "internal server error"
}