I have a question about the /payroll/:year/:period endpoint.
When I run it against some dates (e.g. /2022/0) I get all the expected data back. However when I run it for newer dates (in my case from 2023 onwards) I get a 404.
All the payroll information is available in the FreeAgent UI. I have level 7 access and the API is configured to access my own FreeAgent account.
We can have a look at the logs to see what’s going on - but we need the subdomain for the company you’re retrieving the payroll data for. I’ll send you a DM now, which you should be able to reply to and tell me which company it is.
I’ve had a look at the logs and I can see where you were getting the 404s but it appears to be happening as there are no payroll periods on the account for the 2022/23 tax year onwards. The last completed period is March 2022.
I can see that you have payslips after that date, which I’m assuming have been imported by your Accountant, but unfortunately those are not retrievable via the API as they don’t get linked to a period in the background. It’s only the payslips which have been generated from within the FreeAgent web app that can be retrieved via the API - the ones imported via a CSV on the Practice dashboard don’t get linked to a period, hence why when you query the period you don’t get anything back.
Sorry I couldn’t offer you a solution, but hopefully that explains why they’re missing. I’ll add retrieving imported payslips onto our product backlog as a feature request as I can see how it would be useful, but our backlog is already pretty full so I can’t offer any guarantee as to if or when we’ll get to it
Thank you for looking into it and for the explanation - even though there is no current solution, it is definitely helpful information. I do recall my accountants previously mentioning they bulk upload payroll data, as it avoids them having to do it individually for each of their clients.
Thank you for adding the feature request - it will be super helpful if it can be done as it will ensure no data gets missed.
Does FreeAgent publish their releases / feature implementation anywhere, so I can try to stay up-to-date with the updates?
For general product updates, the best place is probably the FreeAgent blog or for API specific updates we usually post here on the forum in the announcements topic - which you should be able to turn on notifications for.
