Get a deduction type

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

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

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

import requests

url = "https://api.panoflow.io/v1/payroll/deduction-types/{deduction_type_id}"

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

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

print(response.text)

{
  "id": "<string>",
  "object": "deduction_type",
  "created_at": "2026-10-27T08:41:00Z",
  "updated_at": "2026-10-27T08:41:00Z",
  "name": "<string>",
  "kind": "tax_table",
  "how": "<string>",
  "applies_to": "everyone",
  "enabled": true,
  "custom": true,
  "people_count": 123,
  "short_name": "<string>",
  "rate_bps": 5000,
  "base": "basic",
  "remits_to": "<string>"
}

{
  "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

deduction-types

{deduction_type_id}

Get a deduction type

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

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

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

import requests

url = "https://api.panoflow.io/v1/payroll/deduction-types/{deduction_type_id}"

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

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

print(response.text)

{
  "id": "<string>",
  "object": "deduction_type",
  "created_at": "2026-10-27T08:41:00Z",
  "updated_at": "2026-10-27T08:41:00Z",
  "name": "<string>",
  "kind": "tax_table",
  "how": "<string>",
  "applies_to": "everyone",
  "enabled": true,
  "custom": true,
  "people_count": 123,
  "short_name": "<string>",
  "rate_bps": 5000,
  "base": "basic",
  "remits_to": "<string>"
}

{
  "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

deduction_type_id

string

required

Deduction type id (ded_…).

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

Response

The deduction type.

A deduction set up once for the business (ded_…).

string

required

ded_…

object

string

required

Always deduction_type.

Allowed value: "deduction_type"

created_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

updated_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

name

string

required

Shown on payslips.

kind

enum<string>

required

How a deduction is worked out. tax_table = PAYE from yearly pay and reliefs (built-in only); percentage = rate × base; fixed = same amount each run; loan = same amount each run until a total is repaid; one_off = taken from the next run only (built-in "Salary advance").

Available options:

tax_table,

percentage,

fixed,

loan,

one_off

how

string

required

Human description of how it is worked out.

applies_to

enum<string>

required

Company-wide or added per person.

Available options:

everyone,

selected_people

enabled

boolean

required

Taken from runs when true.

custom

boolean

required

False for built-in types.

people_count

integer

required

People it currently applies to.

short_name

string

Short tag for tables.

rate_bps

integer

For percentage.

Required range: 0 <= x <= 10000

base

enum<string>

For percentage.

Available options:

basic,

basic_housing_transport,

gross

remits_to

string

Where the money goes. Absent when it stays in the business.

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Get a deduction type

Authorizations

Headers

Path Parameters

Response