Payroll
Deductions
Documents
Management
Sandbox
- POSTCreate a new Sandbox Connection
- POSTCreate a new sandbox account
- PUTUpdate a sandbox account
- GETGet configurations for sandbox jobs
- PUTUpdate configurations for sandbox jobs
- POSTAdd a new sandbox payment
- PUTUpdate sandbox individual
- PUTUpdate sandbox employment
- POSTAdd new individuals to a sandbox company
- PUTUpdate a sandbox company's data
- POSTEnqueue a new sandbox job
Development Guides
Get Rules
Beta: this endpoint currently serves employers onboarded after March 4th and historical support will be added soon
List all rules of a connection account.
curl --request GET \
--url https://api.tryfinch.com/employer/pay-statement-item/rule \
--header 'Authorization: Bearer <token>' \
--header 'Finch-API-Version: <finch-api-version>'[
{
"id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"priority": 1,
"effective_start_date": "2025-01-01",
"effective_end_date": "2025-12-31",
"conditions": [
{
"field": "name",
"operator": "equals",
"value": "Salary"
}
],
"attributes": {
"metadata": {
"myLabel": "My Value"
}
},
"entity_type": "pay_statement_item",
"created_at": "2025-01-01T10:00:00Z",
"updated_at": "2025-01-01T10:00:00Z"
},
{
"id": "e8b90071-0c11-471c-86e8-e303ef2f6782",
"priority": 1,
"conditions": [
{
"field": "name",
"operator": "equals",
"value": "Medical Insurance"
}
],
"attributes": {
"metadata": {
"myLabel2": "My Value 2"
}
},
"entity_type": "pay_statement_item",
"created_at": "2025-01-10T10:00:00Z",
"updated_at": "2025-02-05T08:45:00Z"
}
]Authorizations
Please use your Access Token
Headers
Header used to specify the version for a given API request. Current version is 2020-09-17.
Response
Finch id (uuidv4) for the rule.
The priority of the rule.
The datetime when the rule was created.
The datetime when the rule was last updated.
Specifies when the rule should begin applying based on the date.
Specifies when the rules should stop applying rules based on the date.
Specifies the fields to be applied when the condition is met.
The metadata to be attached in the entity. It is a key-value pairs where the values can be of any type (string, number, boolean, object, array, etc.).
The entity type to which the rule is applied.
pay_statement_item Was this page helpful?
curl --request GET \
--url https://api.tryfinch.com/employer/pay-statement-item/rule \
--header 'Authorization: Bearer <token>' \
--header 'Finch-API-Version: <finch-api-version>'[
{
"id": "5d0b10a1-a09a-430f-81f1-20be735dc5e9",
"priority": 1,
"effective_start_date": "2025-01-01",
"effective_end_date": "2025-12-31",
"conditions": [
{
"field": "name",
"operator": "equals",
"value": "Salary"
}
],
"attributes": {
"metadata": {
"myLabel": "My Value"
}
},
"entity_type": "pay_statement_item",
"created_at": "2025-01-01T10:00:00Z",
"updated_at": "2025-01-01T10:00:00Z"
},
{
"id": "e8b90071-0c11-471c-86e8-e303ef2f6782",
"priority": 1,
"conditions": [
{
"field": "name",
"operator": "equals",
"value": "Medical Insurance"
}
],
"attributes": {
"metadata": {
"myLabel2": "My Value 2"
}
},
"entity_type": "pay_statement_item",
"created_at": "2025-01-10T10:00:00Z",
"updated_at": "2025-02-05T08:45:00Z"
}
]