List deductions added to a person

curl --request GET \
  --url https://api.panoflow.io/v1/payroll/people/{person_id}/deductions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/payroll/people/{person_id}/deductions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/payroll/people/{person_id}/deductions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "object": "list",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "id": "pdd_01J8GV764KCRGE00KXHMFYFF1T",
      "object": "person_deduction",
      "created_at": "2026-04-28T10:00:00Z",
      "updated_at": "2026-10-28T09:00:00Z",
      "person_id": "ppl_01J9RMZ9J92V81E5128Q6RW31F",
      "deduction_type": {
        "id": "ded_01J53TW8JZ38AYTNJKGGSFKYS7",
        "name": "Staff loan",
        "kind": "loan"
      },
      "status": "active",
      "amount": {
        "amount": 2500000,
        "currency": "NGN"
      },
      "loan": {
        "total": {
          "amount": 30000000,
          "currency": "NGN"
        },
        "repaid": {
          "amount": 22500000,
          "currency": "NGN"
        },
        "remaining": {
          "amount": 7500000,
          "currency": "NGN"
        },
        "months_left": 3
      }
    }
  ]
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

GET

payroll

people

{person_id}

deductions

List deductions added to a person

curl --request GET \
  --url https://api.panoflow.io/v1/payroll/people/{person_id}/deductions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/payroll/people/{person_id}/deductions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/payroll/people/{person_id}/deductions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "object": "list",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "id": "pdd_01J8GV764KCRGE00KXHMFYFF1T",
      "object": "person_deduction",
      "created_at": "2026-04-28T10:00:00Z",
      "updated_at": "2026-10-28T09:00:00Z",
      "person_id": "ppl_01J9RMZ9J92V81E5128Q6RW31F",
      "deduction_type": {
        "id": "ded_01J53TW8JZ38AYTNJKGGSFKYS7",
        "name": "Staff loan",
        "kind": "loan"
      },
      "status": "active",
      "amount": {
        "amount": 2500000,
        "currency": "NGN"
      },
      "loan": {
        "total": {
          "amount": 30000000,
          "currency": "NGN"
        },
        "repaid": {
          "amount": 22500000,
          "currency": "NGN"
        },
        "remaining": {
          "amount": 7500000,
          "currency": "NGN"
        },
        "months_left": 3
      }
    }
  ]
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Path Parameters

person_id

string

required

Payroll person id (ppl_…).

Pattern: ^ppl_[0-9A-HJKMNP-TV-Z]{26}$

Query Parameters

status

enum<string>[]

Comma-separated statuses. Default active.

Available options:

active,

completed,

removed

Response

The person's deductions.

Cursor page. Domain files compose this with allOf and set data.items.

object

string

required

Allowed value: "list"

data

object[]

required

Items, newest first.

Show child attributes

has_more

boolean

required

True when another page exists.

next_cursor

string | null

Cursor for the next page in the same direction: pass it as after if this page was read with after (or no cursor), as before if it was read with before. Null when has_more is false.

total_count

integer

Only when include=total_count was sent.

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

List deductions added to a person

Authorizations

Headers

Path Parameters

Query Parameters

Response