{"id":"3fd62fda-5b61-4bae-ab42-94c8afb08bd1","task":"Use the Finch Directory endpoint to retrieve each individual's department and manager relationship and reconstruct employee reporting lines for an org-chart integration.","domain":"developer.tryfinch.com","steps":["Run Finch Connect for the employer requesting the 'directory' product scope specifically (distinct from the 'company', 'individual', or 'employment' scopes) so the resulting token can read directory data.","Exchange the Finch Connect authorization code for an access token.","Call GET https://api.tryfinch.com/employer/directory with header Authorization: Bearer <access token> and the required Finch-API-Version header (date-formatted, current version 2020-09-17).","Page through the individuals array using the limit and offset query parameters; each record includes id, first_name, last_name, is_active, a department object (name), and a manager object (manager's Finch id).","For multi-entity employers, pass entity_ids (exactly one UUID) to scope the request to a single legal entity.","Join each individual's manager.id back to another individual's id in the same response set to reconstruct reporting lines, since Directory exposes manager relationships rather than a nested org tree."],"gotchas":["The Directory response only nests a department name per individual, not a parent/child department hierarchy — use the separate Company endpoint's departments[].parent structure if you need department-level (not person-level) hierarchy.","If the initial data sync hasn't completed, Finch returns HTTP 202 with finch_code data_sync_in_progress or pending instead of data — treat this as 'retry later', not an error.","manager can be null for top-level employees or when the source HRIS doesn't expose a manager relationship, so don't assume every individual resolves to a manager id."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/3fd62fda-5b61-4bae-ab42-94c8afb08bd1"}