{"id":34513710,"url":"https://github.com/leon1995/factorialhr","last_synced_at":"2025-12-24T04:16:54.759Z","repository":{"id":146026234,"uuid":"615846286","full_name":"leon1995/factorialhr","owner":"leon1995","description":"Python wrapper for the api of FactorialHR","archived":false,"fork":false,"pushed_at":"2025-10-31T19:23:34.000Z","size":336,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-31T21:15:22.458Z","etag":null,"topics":["api","factorialhr","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leon1995.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-18T21:04:12.000Z","updated_at":"2025-10-31T19:22:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"91a55777-2d54-47ac-b331-a4dd1f3981b5","html_url":"https://github.com/leon1995/factorialhr","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/leon1995/factorialhr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leon1995%2Ffactorialhr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leon1995%2Ffactorialhr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leon1995%2Ffactorialhr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leon1995%2Ffactorialhr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leon1995","download_url":"https://codeload.github.com/leon1995/factorialhr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leon1995%2Ffactorialhr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27994527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","factorialhr","python"],"created_at":"2025-12-24T04:16:53.228Z","updated_at":"2025-12-24T04:16:54.753Z","avatar_url":"https://github.com/leon1995.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FactorialHR api python wrapper\n\nThis package provides a python wrapper to the [api of FactorialHR](https://apidoc.factorialhr.com/docs).\n\nThe package currently supports the api version [2025-10-01](https://apidoc.factorialhr.com/v2025-10-01/docs/getting-started).\n**I derived some types from the examples given. They might be incorrect. If you encounter any problems, please create an issue and/or contribute a fix.**\n\n## Disclaimer\n\nI am not affiliated, associated, authorized, endorsed by, or in any way officially connected with EVERYDAY SOFTWARE, S.L. or FactorialHR, or any of its subsidiaries or its affiliates. The official factorialhr.com website can be found at https://factorialhr.com/\n\n## Usage\n\nGet all employees\n```python\nimport factorialhr\n\nauthorizer = factorialhr.ApiKeyAuth('\u003capi_key\u003e')  # checkout other authorization methods\nasync with factorialhr.ApiClient(auth=authorizer) as api:\n    all_employees = await factorialhr.EmployeesEndpoint(api).all()  # fetches all employees. on big companies you might want to increase the timeout by using timeout=...\n```\nGet a dictionary with team id as key and a list of member as value\n```python\nimport asyncio\n\nimport factorialhr\n\nauthorizer = factorialhr.AccessTokenAuth('\u003caccess_token\u003e')  # checkout other authorization methods\nasync with factorialhr.ApiClient(auth=authorizer) as api:\n        employees_endpoint = factorialhr.EmployeesEndpoint(api)\n        teams_endpoint = factorialhr.TeamsEndpoint(api)\n        all_employees, all_teams = await asyncio.gather(employees_endpoint.all(), teams_endpoint.all())  # remember to increase the timeout if you have a lot of employees or teams\n        employees_by_team_id = {team.id: [employee for employee in all_employees.data() if employee.id in team.employee_ids] for team in all_teams.data()}\n```\n\n## Contribute\n\nFeel free to contribute! Please fork this repository, install the development dependencies with `uv sync --dev`\nand create pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleon1995%2Ffactorialhr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleon1995%2Ffactorialhr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleon1995%2Ffactorialhr/lists"}