Public Servant Salary Data API

This API provides access to publicly accessible salary information based on classifications and levels. The information is sourced from TBS-SCT Canada and is available through a set of endpoints.

Important Disclaimer

This API and website are not affiliated with, endorsed, or sponsored by the Government of Canada. The information provided is sourced from publicly available data and is provided for educational and informational purposes only.

Endpoints

  • /api/data: Returns the full JSON containing salary data for all classifications and levels.
  • /api/top: Returns the top salary level for each classification and level.
  • /api/[classification-level]: Returns the full salary information for a specific classification and level (e.g., /api/cs-01).
  • /api/[classification-level]/[step-#]: Returns the salary for the specified step of a classification and level (e.g., /api/cr-1/step-3).
  • /api/[classification-level]/top: Returns the top salary amount of the specified classification and level (e.g., /api/as-4/top).
  • /api/[classification-level]/current: Returns the current salary steps of the specified classification and level (e.g., /api/as-4/current).

Usage

To use the API, send HTTP requests to the specified endpoints using your preferred method (e.g., cURL, Python requests, etc.).

Examples

Here are some example HTTP requests you can use to interact with the API:

  # Retrieve full salary data
  curl https://ps-salary-data.vercel.app/api/data

  # Get top salary levels
  curl https://ps-salary-data.vercel.app/api/top

  # Get full salary info for a classification and level
  curl https://ps-salary-data.vercel.app/api/cs-01

  # Get salary for a specific step
  curl https://ps-salary-data.vercel.app/api/cr-1/step-3

  # Get top salary amount for a classification and level
  curl https://ps-salary-data.vercel.app/api/as-4/top

  # Get current salary steps for a classification and level
  curl https://ps-salary-data.vercel.app/api/as-4/current

Current Classifications Available

Contributing

Contributions are welcome! If you have any suggestions, enhancements, or bug fixes, please submit an issue or a pull request on the GitHub repository

License

This project is licensed under the MIT License.