I forgot to respond here, I posted the 3d approach here:
For a direct dive go to the github:
Can this method be used to connect to Fingagent running in a Docker container? I can’t find information on getting the API key or the URL for Fingagent (in Portainer I don’t see any ports open?)
I cannot check it myself, but the Fing Agent running in Docker exposes the exact same Local API that you get on a Fingbox (or Fing Desktop). Under the hood, they all implement the Fing Local API (version 1.1.0), a physical Fingbox will work similar to a Docker-hosted agent. (unchecked)
Same HTTP endpoints & schema
Whether it’s a Fingbox, Fing Desktop or a Fing Agent container, you’ll find the same REST endpoints, e.g.:
GET http://:49090/1/devices
GET http://:49090/1/people
Responses (JSON) for things like device lists, MAC/IPs, first_seen/last_changed, etc., follow the identical OpenAPI spec
Authentication is identical
All agents require an API key (issued when you activate the unit in your Fing mobile app), passed via ApiKeyAuth headers exactly as with a Fingbox
Hmm… Interestig… Last time I checked the only API available was for devices endpoint. I tried now people endpoint, but get "error": "401 Unauthorized". Perhaps this is because I use very old (from time of kickstarter campain) fingbox v1, that might not received appropriate FW update 
Hi Mirekmal, I also have the V1 from a very long time ago. It works like a charm, but I have a Pro account. I am not sure if that’s required, I think it was for the API, but other members mentioned it was not needed.
Hm… whenever I put anything but devices as endpoint I get the same error. So also people one seems not to exist on my device. Since according to dicumentation API is now fully free, I’d assume, there is something odd with my fingbox. I’m wondering, if by chance my device runs on some old firmware version (though it should update automatically. Strange that documentation provided way of checking FW version also does not work me (in mobile app, from circular 3 dots menu it should be visible under the fingbox icon, but there is nothing there but just connection status and MAC). From web UI I was also not able to figure out FW version
Small update; I was able to determine FW version of my FingBox from Desktop app. it is 1.16.2, that seems to be the latest one. So this is not the problem
I have the same old Fingbox (from Kickstarter), on their free plan, and the API (for /devices) is working fine for me via a rest sensor following the details in this thread…(that I can see /people doesn’t work)
That’s not much help to you I know so if there there is anything I can check for you let me know?
Well, /devices works perfectly fine. I was curious about /people, as I could find some use for it 
1 Like
was mainly to just confirm your findings…don’t think anything “wrong” just doesn’t work and probably never did…
Can anyone tell me how to access my API key?
I have a premium subscription and my windows desktop app isn’t working for some time, I can’t get it to work.
I was wondering if can use on HA and found this forum but since I am so not familiar with this stuff I am asking.
Is there any way to get a working Fing Setup in HA? I checked on add Ons and HACS, these are the two places I get my add On’s from.
Thank you
More a question for Fing support, not for this forum.
Since fing was added in 2025.11 I decided to take a look. I like it, sort of.
I have the fing agent on docker in a Proxmox container. I have the newly official integration running.
BUT… it only pulls in 18 of my 66 devices. None of which are relevant for presence tracking, like phones (1 Android, 1 iPhone).
I can’t seem to find any info referencing how to determine was is pulled into HA. A Gemini query seems to indicate everything monitored in fing should come over.
Anyone know anything about this?
EDIT: should have mentioned that I purchased the Starter subscription.
Did you do anything special with your docker? For the life of my I can get the app to find Fing agent with it in a docker in proxmox also.
It took a while at first to find it, several tries with no luck. I then went away, came back a few hours later and it had found it. Otherwise, I don’t think I did anything special. I followed this video: Docker Container 24/7 Network Monitoring Agent #shorts #iphone #android #wifi - YouTube
Is a paid subscription required for the local API to work?
I am currently running FING Desktop free version on my home computer, and when I enable the local API function, and try to add the integration it just errors out. Am I doing something wrong or is this a paid feature to be able to use the Local API with Home Assistant?
My understanding is that it is free to use the local API (e.g. via Fing desktop) and I initially did that. But, I didn’t want to rely on my local PC, I wanted the agent on my Proxmox cluster which is on 7x24.
Further, I believe you need a paid subscription for the Agent (e.g. running on docker).
I bought the starter subscription and the fing agent on docker works for me.
Trying to connect to Fing Desktop and getting “time out error” HA 2025.11.1
when using the web link from browser I’m getting the JSON list.