validate xbrl local

51 views
Skip to first unread message

Jose Anota

unread,
Dec 11, 2025, 10:04:45 AM (12 days ago) Dec 11
to Arelle-users
Hello, I'm new to working with XBRL files and I'm trying to validate files against Arelle command line in web server mode. I'd appreciate it if someone could provide an example of how to make the request so that the validation is performed against a taxonomy on a local file instead of searching for the URL in the XBRL file.

Thank you very much.

#validation
#arelle
#xbrl

Austin Matherne

unread,
Dec 11, 2025, 12:06:00 PM (12 days ago) Dec 11
to Arelle-users
Hi Jose,

The most basic example without any plugins looks like this:

> python arelleCmdLine.py --webserver localhost:8080
>   --header 'Content-Type: application/zip' \
>   --header 'X-File-Name: 2138002P5RNKC5W2JZ46-2024-02-24.zip' \
>   --data-binary '@/Users/austinmatherne/Documents/xbrl/filings/tesco/2138002P5RNKC5W2JZ46-2024-02-24.zip'

Kind regards,
Austin Matherne

Jose Anota

unread,
Dec 12, 2025, 1:55:42 AM (12 days ago) Dec 12
to Arelle-users
Thank you very much, Austin.
I'm having trouble when I don't have an internet connection and the XSD file included in the XBRL file can't be resolved. How can I validate it against the XSD file in a local folder, or against the .zip file containing the taxonomy?

Thanks.

Austin Matherne

unread,
Dec 12, 2025, 4:39:43 PM (11 days ago) Dec 12
to Arelle-users
If the authors of the taxonomy the filing references publish a taxonomy package, you can provide it to Arelle using the `--package` command line arg. Also, if you don't expect Arelle to have network access (or don't want it to) you can use the `--internetConnectivity offline` option, which will block network requests, but also load some core xbrl.org schemas from an internal cache instead of checking for updated versions.

> python arelleCmdLine.py --internetConnectivity offline --package esef_taxonomy_2024.zip --webserver localhost:8080

Kind regards,
Austin Matherne

Jose Anota

unread,
Dec 15, 2025, 4:50:48 AM (8 days ago) Dec 15
to Arelle-users
Thank you so much, Austin. I finally managed to validate against the local taxonomy, and the problem was with the taxonomy file, which wasn't properly constructed. Thank you so much for your help.
Reply all
Reply to author
Forward
0 new messages