canonical: https://jentic.com/apis/salarybox.in/salarybox

# Salarybox In API Reference

The SalaryBox API reads staff, attendance, leave, and payroll records from a company's SalaryBox account, the Indian staff management and payroll app. It returns daily attendance, the monthly muster, punch time entries, shifts, breaks, and holiday lists for a date range, filterable by SalaryBox id, branch, or department. Payroll reads cover employee CTC, salary breakdowns, salary and advances paid, and a payroll summary for a month, and pending leave, reimbursement, and device-verification requests can be listed for review.

## For AI agents

Read SalaryBox staff lists, daily attendance and punches, leave balances, and monthly payroll figures such as CTC and salary paid.

## Scope

Does not run payroll, approve requests, or mark attendance. Use for reading SalaryBox staff, attendance, leave, and payroll records only.

## Capabilities

- Pull daily attendance, the attendance muster, and punch time entries for a start_date to end_date range
- Filter attendance by SalaryBox ids, branch names, or department names
- Look up staff by name, employee id, branch, department, job title, or phone number
- Read employee CTC, monthly salary breakdowns, and salary and advance amounts paid
- Generate a payroll summary for a month from its month_from_date
- Check leave balances and leave policies for staff
- List pending leave, reimbursement, and device-verification requests awaiting approval

## Use cases

### AI agent HR assistant

An AI assistant for a small business owner answers questions like who was absent today or how much leave someone has left. Through Jentic the agent searches for 'get daily attendance', loads the SalaryBox operation with its input schema, and calls it with the required start_date and end_date while the API key is attached at call time. It replies with the attendance list without the owner opening the dashboard.

Example prompt: Call GET `/attendance/daily` with start_date and end_date set to today and summarise the attendance returned for each staff member

### Monthly payroll reconciliation

Finance teams closing a month compare what each employee should earn with what was paid. SalaryBox returns employee CTC, a salary breakdown for a required month, salary paid, and advances paid, and POST `/payroll/summary` produces a summary from month_from_date. Together these feed a reconciliation sheet or accounting import.

Example prompt: Fetch GET `/payroll/fetch-salary-breakdown` for month 2026-10 and GET `/payroll/fetch-salary-paid`, then flag employees whose paid amount differs from the breakdown

### Approval queue digest

Managers miss approvals buried in the app. SalaryBox lists pending leave requests, pending reimbursements, and pending device-mapping verifications, so a scheduled job can send a morning digest of everything awaiting action. Leave balances and policies add context to each leave request.

Example prompt: List GET `/pending-requests/leave` and GET `/pending-requests/reimbursements` and post a combined summary of open requests

### Attendance export for branches

Multi-branch businesses need attendance per site for compliance and wages. The muster, time-entry, shift, and break operations accept branch_names and department_names filters with pagination, so each branch's register can be exported for the month.

Example prompt: Call GET `/attendance/muster` for October with branch_names set to one branch and page through all results

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/attendance/daily` | Daily attendance |
| GET | `/attendance/muster` | Attendance muster |
| GET | `/staff/` | List staff |
| GET | `/leave/balance` | List leave balances |
| GET | `/payroll/fetch-salary-breakdown` | Fetch salary breakdown |
| POST | `/payroll/summary` | Payroll summary |
| GET | `/pending-requests/leave` | List pending leave requests |

## Key resources

- **Staff** — Staff list with filters, employee list, and pending device-mapping requests
- **Attendance** — Daily attendance, muster, punches, shifts, breaks, and holiday lists
- **Payroll** — Employee CTC, salary breakdown, salary and advances paid, payroll summary, and pending reimbursements
- **Leave** — Leave balances, leave policies, and pending leave requests
- **Company** — Company profile

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 46 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 23 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 81 / 100
- **View full report:** https://jentic.com/apis/salarybox.in/salarybox/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring SalaryBox by hand means formatting the Authorization header as Api-Key followed by your key, supplying required date or month parameters, and paging through page and page_size on every list. Through Jentic you install once, import SalaryBox from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** SalaryBox selects employees, branches, and dates through query parameters rather than path ids, so rules bound which operations your agent may call, such as the attendance reads, not which employees it sees. You choose the operations it may call, so payroll reads like CTC and salary paid are not included unless you add them.
- **Credential handling:** Your SalaryBox API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get daily attendance' or 'list pending leave requests', and Jentic returns the matching SalaryBox operation with its input schema so the agent supplies the required dates and filters.

## Related APIs

- **BambooHR** — HR information system for employee records and time off
- **Gusto** — US payroll and benefits platform
- **Razorpay** — Indian payments platform for paying out salaries and reimbursements

## FAQ

### What authentication does the SalaryBox API use?

Per its OpenAPI spec, the SalaryBox API uses an API key sent in the `Authorization` header in the format `Api-Key {api-key}`, declared on every operation. Through Jentic the key is stored by your own instance and added at call time, so the agent never sees it.

### Can I filter SalaryBox attendance by branch or department?

Yes. GET `/attendance/daily`, `/attendance/muster`, and `/attendance/time-entry` take required start_date and end_date parameters plus optional salarybox_ids, branch_names, and department_names filters, with page and page_size for pagination.

### What are the rate limits for the SalaryBox API?

The OpenAPI spec does not specify rate limits. Check the SalaryBox documentation at https://docs.salarybox.in for current limits before scheduling large attendance exports.

### Is there a SalaryBox MCP server?

You don't need an MCP server to give your agent SalaryBox. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the attendance, leave, and payroll operations it needs, discovered on demand.

### How do I get a payroll summary from SalaryBox through Jentic?

Search Jentic for 'payroll summary for a month', load the POST `/payroll/summary` operation, and execute it with the required month_from_date in the body. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the SalaryBox API?

Yes. For an attendance assistant, write a rule that allows only the GET operations under /attendance/ and /leave/, so the agent can answer attendance and leave questions while salary, CTC, and payroll figures stay out of reach. Each call it makes is logged.
