{"_id":"@1dex-fr/1dex","_rev":"8-77c4ebe2f782beed9bb8b44d26d50bdf","name":"@1dex-fr/1dex","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@1dex-fr/1dex","version":"0.1.0","keywords":["1dex","cadastre","parcelles","geojson","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.0","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"514794f740e8404eba560bfda09fbb3187b76a3d","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.0.tgz","fileCount":3,"integrity":"sha512-em9lBk+4eWQ4vtsdcdzBZNYVSbu+sYrJJYaaE7WHP/kd9K/Cu43DfRdScoDrV4hYqiPr1gplmQ69JneNT0aB6Q==","signatures":[{"sig":"MEYCIQCK/0v2g2ZgFwOe3k4cQOZapmZp7ZslCvzoq6ohisngXgIhAM9ju0Es3ik1qr3EpprUfRDX3x0NBYH0NnQpUnHesvM6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7260},"type":"module","engines":{"node":">=22"},"gitHead":"7fc1869dd5937409f1e2874ce0e5e6769a17f25a","_npmUser":{"name":"1dex-fr","email":"service@1dex.fr"},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.5.2","description":"CLI for the public 1dex parcel map-layer endpoint.","directories":{},"_nodeVersion":"22.18.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.0_1778925553351_0.7470216515841139","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@1dex-fr/1dex","version":"0.1.2","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.2","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"06c8ac383b3354e1a8d1dce05f6b44d22e16be90","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.2.tgz","fileCount":3,"integrity":"sha512-WnyWI83wLcyJmLlOC9gZ2Db0KK6HkExZDLWgT/gKYdfp1RaC8S9wNRXv+7QlXfHytbAA1Q4jlEIarYEj5E8OCQ==","signatures":[{"sig":"MEUCIQCP0FuhRuH+VGFzrgPs7204b42pT/083+lAl9zMFv8IRwIgZEoRUbl5qMxRpELc3/vvLAbX/XsJe2Am456Tm7pjN4Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":18475},"type":"module","engines":{"node":">=22"},"gitHead":"838c2aabc1e2ae5da22c22e8d79af6c4b966a32d","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.12.1","description":"Free CLI to test 1dex public address data: retrieve parcel GeoJSON around a French address and discover the advanced real-estate address API.","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.2_1778931024136_0.18294876588259767","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@1dex-fr/1dex","version":"0.1.3","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.3","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"9532da135a58865bffe0be77b23277e703468eee","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.3.tgz","fileCount":3,"integrity":"sha512-AckYwdW2PVX96HpvWiyJ+GyxOTeeH8KAFer207+byrq7v1NK16CQ7Aiv9Zt1oDWIydK2L6votAH4X6WtgIAE+Q==","signatures":[{"sig":"MEUCIDD71BiRQvCx5VxDFjgLihPm81W7vOxfZNXjQA8z1kvTAiEAySv7evJn3zmzTownFjGbiHup84nqr9PMOZzRUBt/oNA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":21218},"type":"module","engines":{"node":">=22"},"gitHead":"5544ce7a6596d6a16cb1d91c199e4690aa326d3f","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.12.1","description":"Free CLI to test 1dex public address data: retrieve parcel GeoJSON around a French address and discover the advanced real-estate address API.","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.3_1779284215894_0.7388756124704425","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@1dex-fr/1dex","version":"0.1.4","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.4","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"2f09b0f9db2d78d6f4222e47702726b1f3157428","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.4.tgz","fileCount":3,"integrity":"sha512-Y4Cua6Nl3dPF+LIimwcEaKBywgjG9DGW/KxA4PhOUMhSeSNVK2KWcLP1BHERVVcTYDZZAN/2tS0YoW199Bnz1A==","signatures":[{"sig":"MEQCIEsXxaY0g2v3NH7nn8k3hepyME5sDeC7AEFejV8VCT2sAiAZid1fwU98xX1S5VEaJwjKRJzoEhmONMMo8I7mxc/rgA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":23832},"type":"module","engines":{"node":">=22"},"gitHead":"2e4495092cd579dc5c0626ebbddd23ee6b2696fc","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.12.1","description":"Free CLI to test 1dex public address data: retrieve parcel GeoJSON around a French address and discover the advanced real-estate address API.","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.4_1779290447976_0.2661239038022851","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@1dex-fr/1dex","version":"0.1.5","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.5","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"1f619a2e7a37cf8223049675d3eac5590eb91f65","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.5.tgz","fileCount":3,"integrity":"sha512-7Fozq1fZjP+5lGgPktfVfCwPoPE710Owla382EyYxJ1sIsdrapb9raqKY+Ooy/iG4TV76V0usV1pm06eMLf8vw==","signatures":[{"sig":"MEUCIQDNICU+y3ePMidam5laApLc1wxuhMRKOrn07PyVpqezowIgbv5ignS4LsxEFPhxRQ5+/wTwabsHYNScmyArbdDX6ds=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":44005},"type":"module","engines":{"node":">=22"},"gitHead":"1461c15d9212ddbad1a1517c75b2dc9d33f10dbc","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.13.0","description":"CLI for the public 1dex API surface: overview, autocomplete, score, address state, and map routes.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.5_1780352129723_0.9907974066524883","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@1dex-fr/1dex","version":"0.1.6","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.6","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"de28ae3021d1e98028be5a1a75e25e287debe28b","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.6.tgz","fileCount":3,"integrity":"sha512-2JR85OSpdp9O0YYABRe+eRX3ht3D6Qn/c+H1gQlFl42hZo1mj6YTnpTXF2jKeKKBZeETEnNqkwWkowMuqwczcQ==","signatures":[{"sig":"MEYCIQDMyf46gnik0bN2y7byWPE3A86/UNdrgobVsG8/pHVsWwIhAJwt1lqeGHMnhyIShWnXDlIMupbunCMuGBkccN345L0g","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":64512},"type":"module","engines":{"node":">=22"},"gitHead":"c50754265af6524289aefe75def3f1ac50658399","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.17.0","description":"CLI for the public 1dex API surface: overview, subscriber address details, autocomplete, score, preview, account usage, and map routes.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.6_1781689111319_0.929716656405001","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@1dex-fr/1dex","version":"0.1.7","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"license":"MIT","_id":"@1dex-fr/1dex@0.1.7","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"homepage":"https://blipn.github.io/1dex-connector/","bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"bin":{"1dex":"src/cli.js"},"dist":{"shasum":"cced5f973891915ac08c23ca3e84ac69332c1cd0","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.1.7.tgz","fileCount":4,"integrity":"sha512-8deq2QeqpuQszTYRK9zAUj4pYa08A2fn6hJVC0KpX0MX14ZMkNTCo/E4Wru4zcFeujsXN0S1q/HmLpk8bjlq8g==","signatures":[{"sig":"MEYCIQCr/kjHGstLKEhhJtt21eLCeVmoRytBJMSYTEONapEWOgIhAKStIXflYd2tLXXC0Ch01L5PtewwXvpc/Z8QCt3ouIos","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.1.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":68627},"type":"module","engines":{"node":">=22"},"gitHead":"e3e053caf954e86b4e207423b43c9d50c6a14abc","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"repository":{"url":"git+https://github.com/blipn/1dex-connector.git","type":"git","directory":"cli"},"_npmVersion":"11.13.0","description":"CLI for the public and professional 1dex API surface: overview, subscriber address details, autocomplete, score, preview, account usage, and map routes.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/1dex_0.1.7_1781700637371_0.7269746330228364","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@1dex-fr/1dex","version":"0.2.0","dependencies":{"@1dex-fr/connector":"0.2.0"},"description":"CLI for the public and professional 1dex API surface: overview, subscriber address details, autocomplete, score, preview, account usage, and map routes.","type":"module","bin":{"1dex":"src/cli.js"},"keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"homepage":"https://blipn.github.io/1dex-connector/","repository":{"type":"git","url":"git+https://github.com/blipn/1dex-connector.git","directory":"cli"},"bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"engines":{"node":">=22"},"license":"MIT","_id":"@1dex-fr/1dex@0.2.0","_integrity":"sha512-+WuwcwLAaTtKHZH4hkeeGCLrwIC2udmSnGzUZm9CwYFycExk/MJfu0qxgIa4QKMBO85x6n/6r4sy533u6N/Shg==","_resolved":"/home/runner/work/_temp/1dex-fr-1dex-0.2.0.tgz","_from":"file:/home/runner/work/_temp/1dex-fr-1dex-0.2.0.tgz","_nodeVersion":"24.20.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-+WuwcwLAaTtKHZH4hkeeGCLrwIC2udmSnGzUZm9CwYFycExk/MJfu0qxgIa4QKMBO85x6n/6r4sy533u6N/Shg==","shasum":"f19b5dc82c2c532d5211e0dc76072cd8df059ef7","tarball":"https://registry.npmjs.org/@1dex-fr/1dex/-/1dex-0.2.0.tgz","fileCount":4,"unpackedSize":62058,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1dex-fr%2f1dex@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvMo+MFpWmpTheGYjlPtj1j7nRqYgwmxqTLxGNiJKTkwIhAP71o2BdJ2v+QzldJz3LoysXThe8kScDiGtdoL0M53xM"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ef4ca09b-63ff-4fdf-8356-ff12d80e25d5"}},"directories":{},"maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/1dex_0.2.0_1788794108667_0.8836417286755591"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-16T09:59:12.847Z","modified":"2026-09-07T15:15:09.217Z","0.1.0":"2026-05-16T09:59:13.488Z","0.1.2":"2026-05-16T11:30:24.300Z","0.1.3":"2026-05-20T13:36:56.038Z","0.1.4":"2026-05-20T15:20:48.109Z","0.1.5":"2026-06-01T22:15:29.932Z","0.1.6":"2026-06-17T09:38:31.450Z","0.1.7":"2026-06-17T12:50:37.525Z","0.2.0":"2026-09-07T15:15:08.796Z"},"bugs":{"url":"https://github.com/blipn/1dex-connector/issues"},"license":"MIT","homepage":"https://blipn.github.io/1dex-connector/","keywords":["1dex","1dex-fr","immobilier","real-estate","proptech","adresse","address","cadastre","parcelles","parcel","geojson","geocoding","open-data","france","dvf","urbanisme","risques","api","cli"],"repository":{"type":"git","url":"git+https://github.com/blipn/1dex-connector.git","directory":"cli"},"description":"CLI for the public and professional 1dex API surface: overview, subscriber address details, autocomplete, score, preview, account usage, and map routes.","maintainers":[{"name":"1dex-fr","email":"service@1dex.fr"}],"readme":"# 1dex\n\nCommand-line client for the public and professional 1dex connector.\n\nThe CLI covers the public address overview, subscriber address details and unlocks, account usage, autocomplete, commune search, score endpoints, public previews, address-page state, and verified public map-layer / viewport / focus routes on `1dex.fr`. Use `overview` when you want the address cards flow; `details` / `unlock` for subscriber address flows; `autocomplete`, `communes`, or `score suggest` for search; `score` for scoring and compare flows; `state` / `preview` for public page metadata; and the map commands when you need parcelles, DVF, works, IRIS, context, labels, focus, or multi-layer viewports. The bare form `1dex <address>` remains the compatibility shortcut for the public address overview.\n\n## Install\n\n```bash\nnpm i -g @1dex-fr/1dex\n1dex overview \"10 rue des cordeliers aix\" --dvf-radius-m 300\n```\n\nOr install it in a project and run it with `npx`:\n\n```bash\nnpm i @1dex-fr/1dex\nnpx 1dex overview \"10 rue des cordeliers aix\" --dvf-radius-m 300\nnpx 1dex address details \"10 rue des cordeliers aix\" --fields summary,rail --idempotency-key \"$ONEDEX_DETAILS_REQUEST_ID\" --api-key \"$ONEDEX_API_KEY\"\nnpx 1dex autocomplete \"10 rue des cordeliers aix\"\nnpx 1dex score address \"10 rue des cordeliers aix\" -f summary\nnpx 1dex parcelles \"50 rue des tanneurs aix\" -f summary\n```\n\n## Usage\n\n```bash\n1dex overview \"10 rue des cordeliers aix\" --dvf-radius-m 300\n1dex overview --city-code 13001 --parcel-record-key parcel_123 --dvf-year 2024 --url\n1dex address details \"10 rue des cordeliers aix\" --fields summary,rail,tabs --idempotency-key \"$ONEDEX_DETAILS_REQUEST_ID\" --api-key \"$ONEDEX_API_KEY\" --max-attempts 3\n1dex address unlock \"10 rue des cordeliers aix\" --idempotency-key \"$ONEDEX_UNLOCK_REQUEST_ID\" --api-key \"$ONEDEX_API_KEY\" --max-attempts 3\n1dex address unlock --input '{\"address\":\"10 rue des cordeliers aix\",\"city_code\":\"13001\"}' --idempotency-key \"$ONEDEX_UNLOCK_REQUEST_ID\" --api-key \"$ONEDEX_API_KEY\"\n1dex account usage --api-key \"$ONEDEX_API_KEY\" -f summary\n1dex autocomplete \"10 rue des cordeliers aix\" --limit 5\n1dex communes aix --limit 5\n1dex preview /ville/aix-en-provence-13001 --url\n1dex score address \"10 rue des cordeliers aix\" -f summary\n1dex score compare --input '{\"items\":[{\"address\":\"10 rue des cordeliers aix\"},{\"address\":\"50 rue des tanneurs aix\"}],\"sortBy\":\"global\"}'\n1dex viewport \"10 rue des cordeliers aix\" --layers context,iris -f summary\n1dex focus public-location --lon 5.446766 --lat 43.529667 -f summary\n1dex parcelles \"50 rue des tanneurs aix\" --format summary\n```\n\n## Auth, purchase, and detailed reads\n\nPublic commands such as `overview`, `autocomplete`, `score`, `preview`, `communes`, and `map` do not require an API key within public quotas. Complete address details and unlock flows require a 1dex API key. Free demo keys are pinned to the configured demo address; live keys use the account's subscription and activation rights. Manage keys at <https://1dex.fr/compte/api> and pass one with `--api-key` or `ONEDEX_API_KEY`.\n\nRecommended subscriber flow:\n\n1. Check live/demo usage with `1dex account usage --api-key \"$ONEDEX_API_KEY\" -f summary`.\n2. Try `1dex address details \"<address>\" --fields summary,rail --idempotency-key \"$ONEDEX_DETAILS_REQUEST_ID\" --api-key \"$ONEDEX_API_KEY\"`.\n3. If the API returns `address_unlock_required`, run `1dex address unlock --normalized-address-key <key> --idempotency-key \"$ONEDEX_UNLOCK_REQUEST_ID\"`, or pass the returned `unlock_request` JSON.\n4. Follow the returned URL with `1dex address details --details-url '<details_url>' --idempotency-key '<new-key>'`.\n\nReuse a key only for retries of the exact same intention. `--max-attempts` retries `202`, `429`, and `503` with that key and respects `Retry-After`; `409` is terminal.\n\nCommon professional API errors:\n\n- `invalid_api_key`: the API key is missing, invalid, or revoked.\n- `api_subscription_required`: the account needs an active subscription.\n- `api_professional_required`: the endpoint requires a professional plan.\n- `address_unlock_required`: the detailed address must be unlocked before reading.\n- `insufficient_credits`: the account has no remaining address credits for the requested unlock.\n\n`1dex overview` calls `https://1dex.fr/api/v1/address-overview` and prints the public address overview payload. It accepts the live public location parameters (`address`, `city_code`, `lon`/`lat`, `parcel_record_key`, `dvf_radius_m`, `dvf_year`); the bare `1dex <address>` form keeps the same overview route for backwards compatibility. `details`, `unlock`, and `usage` remain aliases of the canonical `address details`, `address unlock`, and `account usage` commands. They use API keys from `--api-key` or `ONEDEX_API_KEY`. When using `--normalized-address-key`, pass it alone; do not combine it with address text, `--parcel-record-key`, or `--lon`/`--lat`. `usage` understands V1 and `account-usage-v2`. `autocomplete`, `communes`, `preview`, `state`, `viewport`, `focus`, and `score *` target the canonical `/api/v1` routes. The map-layer commands call `https://1dex.fr/api/v1/map-layer/{layer}` and print JSON, CSV, or a short summary.\n\n```bash\n1dex overview \"10 rue des cordeliers aix\" --dvf-radius-m 300\n1dex \"10 rue des cordeliers aix\"\n1dex address details \"10 rue des cordeliers aix\" --fields summary,rail --idempotency-key \"$ONEDEX_DETAILS_REQUEST_ID\"\n1dex autocomplete \"10 rue des cordeliers aix\" --url\n1dex communes aix --url\n1dex state \"10-rue-de-la-paix-paris-75002\"\n1dex score grid --bbox 5.4457,43.5274,5.4468,43.5282 --zoom 15 --category global\n1dex parcelles \"50 rue des tanneurs aix\" --format csv\n1dex parcelles \"50 rue des tanneurs aix\" --url\n```\n\nRun `1dex examples` for copy-paste commands and `1dex doctor` to verify that the public endpoint answers from your machine.\n\n## Options\n\n```text\n1dex <address> [options]\n1dex overview <address|--city-code|--lon/--lat|--parcel-record-key> [options]\n1dex address details <address|--normalized-address-key|--parcel-record-key|--lon/--lat|--details-url> --idempotency-key <key> [options]\n1dex address unlock <address|--normalized-address-key|--parcel-record-key|--lon/--lat|--input> --idempotency-key <key> [options]\n1dex account usage [options]\n1dex autocomplete <query> [options]\n1dex communes <query> [options]\n1dex preview <path> [options]\n1dex state <slug>\n1dex parcelles <address> [options]\n1dex dvf <address> [options]\n1dex travaux <address> [options]\n1dex iris <address> [options]\n1dex labels <address> [options]\n1dex layer <layer> <address|--lon/--lat> [options]\n1dex viewport <address|--lon/--lat> [options]\n1dex focus parcelle <record-key> [options]\n1dex focus parcelles <record-keys> [options]\n1dex focus address <address> [options]\n1dex focus public-location --lon <number> --lat <number> [options]\n1dex focus feature --layer-key <layer> --feature-key <key> [options]\n1dex score address <address> [options]\n1dex score compare [--input <json-or-@file>] [options]\n1dex score grid --bbox <bbox> --zoom <number> [options]\n1dex score suggest <query> [options]\n1dex examples\n1dex doctor [--address <address>] [options]\n```\n\nSet `ONEDEX_BASE_URL` only if you need to target another compatible environment.\nSet `ONEDEX_API_KEY` for subscriber endpoints when you do not pass `--api-key`.\nSet `ONEDEX_IDEMPOTENCY_KEY` only for the current logical details or unlock intention when you do not pass `--idempotency-key`.\nSet `ONEDEX_NO_UPDATE_CHECK=1` to disable the npm update notice in automated environments.\n","readmeFilename":"README.md"}