{
 "lar_version": "0.1",
 "publisher": {
  "name": "Atlas for Agents",
  "domain": "atlasforagents.com"
 },
 "identity": "https://atlasforagents.com/about.md",
 "catalog": "https://atlasforagents.com/coverage.json",
 "operations": {
  "select_by_attributes": {
   "endpoint": "https://atlasforagents.com/v0/accommodations/it/puglia/alberghiero/2026-09-12/entities_selection.json",
   "protocol": "Other",
   "protocol_note": "a plain HTTP GET of a static JSON file - no request body, no authentication, no state",
   "kind": "read",
   "returns": "every record's registry_id, name, comune, category_stars and resolution.queryable in one fetch - filter client-side without the full index"
  },
  "lookup_by_identifier": {
   "endpoint": "https://atlasforagents.com/v0/accommodations/it/puglia/alberghiero/2026-09-12/entities_selection.json",
   "protocol": "Other",
   "protocol_note": "a plain HTTP GET of a static JSON file - no request body, no authentication, no state",
   "kind": "read",
   "returns": "the same six fields, keyed by registry_id - find one record's `leaf_url` directly, no template to fill in and no permission question to fail on"
  },
  "retrieve_full_record": {
   "endpoint": "https://atlasforagents.com/v0/accommodations/it/puglia/alberghiero/2026-09-12/entity/IT075072A100068603.json",
   "protocol": "Other",
   "protocol_note": "a plain HTTP GET of a static JSON file - no request body, no authentication, no state. `endpoint` here is a real, verifiable example, not a template: do not construct one by hand from a pattern with `{registry_id}` in it - use the exact `leaf_url` given for the record you want, from either operation above.",
   "kind": "read",
   "returns": "the complete record - every field entities.json and entities_selection.json project down from, including coordinates, provenance and register_fields"
  },
  "browse_by_province": {
   "endpoint": "https://atlasforagents.com/v0/accommodations/it/puglia/alberghiero/2026-09-12/provinces.json",
   "protocol": "Other",
   "protocol_note": "a plain HTTP GET of a static JSON file - no request body, no authentication, no state",
   "kind": "read",
   "returns": "one entry per province, each naming its own file; that file lists its comuni, each with a count and its own file of records - all six selection-index fields, `leaf_url` included: the municipality file is self-sufficient, records and their resolved leaf URLs in one fetch, no second trip to the selection index. Replaces reading the full selection index for a consumer who wants one comune, not the whole coverage."
  },
  "locate_by_municipality": {
   "endpoint": "https://atlasforagents.com/v0/accommodations/it/puglia/alberghiero/2026-09-12/locate_by_municipality.json",
   "protocol": "Other",
   "protocol_note": "a plain HTTP GET of a static JSON file - no request body, no authentication, no state. `municipality` is the Italian *comune*; the field on the records themselves stays `comune`, the register's own column, with its collision warning already declared against it.",
   "kind": "read",
   "returns": "every comune of this coverage's region, not only the ones with a record - name, comune_istat, province sigla, record count, and the comune file's own URL when one exists. Names are the register's own spelling, verbatim: an exact-string match that fails means a spelling mismatch, not an absent comune - read `names_are_verbatim` in the file itself. The comune file this points to carries `leaf_url` on every row - one fetch for the records and their resolved leaf URLs together."
  }
 },
 "context": {
  "specification": "https://github.com/lar-spec/lar/raw/main/schemas/lar.schema.json",
  "working_paper": "https://lar.md/lar/working-paper.md",
  "working_paper_plain_text": "https://lar.md/lar/working-paper.txt",
  "working_paper_pdf": "https://lar.md/lar/working-paper.pdf",
  "working_paper_doi": "https://doi.org/10.5281/zenodo.21622424",
  "working_paper_doi_ssrn": "https://doi.org/10.2139/ssrn.6801118",
  "working_paper_formats_note": "One document, hosted on lar.md because it describes the LAR specification rather than this project. Markdown is canonical for agents. The two DOIs are the same paper deposited twice and are for citation and human landing: Zenodo answers automated clients, SSRN refuses them, so a 403 from the SSRN link is that repository's policy and not an error here.",
  "creator_orcid": "https://orcid.org/0009-0004-0096-4712",
  "site_identity_plain_text": "https://atlasforagents.com/lar/about.txt",
  "site_identity_html": "https://atlasforagents.com/lar/about.html",
  "site_status": "https://atlasforagents.com/lar/status.json",
  "crawler_conduct": "https://atlasforagents.com/crawler",
  "operations_status": "/about.md#operations",
  "how_to_cite_this": "/about.md#how-to-cite",
  "url_to_package_path": "/about.md#url-to-package-path",
  "versions": "/about.md#versions"
 },
 "policies": {
  "terms": "/about.md#licence"
 }
}