Wage Estimator API

Finance

Convert hourly wages to annual salary and vice versa instantly. Calculate daily, weekly, biweekly, and monthly estimates for payroll planning.

Authentication

All API requests require a valid API key passed in the Authorization header as a Bearer token.

Rate Limit

100 requests per minute

Endpoints

1 endpoint available

Overview

The Wage Estimator API converts between hourly wages and annual salaries, providing comprehensive breakdowns across all pay periods (hourly, daily, weekly, biweekly, monthly, annual).

Calculation Assumptions

All calculations are based on standard full-time work schedules:

8 hours per workday
5 days per week (Monday-Friday)
52 weeks per year
260 workdays per year
2,080 work hours per year

What You Get

Provide either hourly wage OR annual salary, and get all of these:

hourly - Hourly rate
daily - Daily earnings (8 hours)
weekly - Weekly earnings (40 hours)
biweekly - Biweekly earnings (80 hours)
monthly - Monthly earnings (annual / 12)
annual - Annual salary (2,080 hours)

Use Cases

Job seekers comparing salary offers
HR professionals calculating compensation packages
Freelancers setting hourly rates based on desired annual income
Payroll systems converting between pay frequencies

Endpoints

POST

/v1/tools/wage-estimator

Calculate wage estimates across all pay periods

Request Body

Content-Type: application/json

Parameter	Type	Required	Description
hourlyWage	number	Optional	Hourly wage in dollars (provide this OR annualSalary)
annualSalary	number	Optional	Annual salary in dollars (provide this OR hourlyWage)

Response Example

{
  "success": true,
  "estimates": {
    "hourly": 25.5,
    "daily": 204,
    "weekly": 1020,
    "biweekly": 2040,
    "monthly": 4420,
    "annual": 53040
  },
  "assumptions": {
    "hoursPerDay": 8,
    "daysPerWeek": 5,
    "weeksPerYear": 52,
    "hoursPerYear": 2080
  }
}

Error Codes

400

Invalid request body or no wage/salary provided

401

Missing or invalid API key

422

Invalid numeric value (must be positive number)

429

Rate limit exceeded

500

Internal server error

Code Examples

# Convert hourly wage to all pay periods
curl -X POST https://api.opentools.ca/v1/tools/wage-estimator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hourlyWage": 25.50}'

# Convert annual salary to all pay periods
curl -X POST https://api.opentools.ca/v1/tools/wage-estimator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"annualSalary": 75000}'

Ready to get started?

Create an API key to start using the Wage Estimator API.