(zettel (meta (back "00001006000000 00001012000000") (backward "00001006000000 00001012000000") (box-number "1") (created "20210126175322") (forward "00001006050000 00001010040100 00001012050200 00001012053500 00001012920000 00001012920500 00001012920800") (modified "20240620170909") (published "20240620170909") (role "manual") (syntax "zmk") (tags "#api #manual #zettelstore") (title "API: Retrieve parsed metadata and content of an existing zettel in various encodings")) (rights 4) (encoding "") (content "The [[endpoint|00001012920000]] to work with parsed metadata and content of a specific zettel is ''/z/{ID}'', where ''{ID}'' is a placeholder for the [[zettel identifier|00001006050000]].\n\nA __parsed__ zettel is basically an [[unevaluated|00001012053500]] zettel: the zettel is read and analyzed, but its content is not __evaluated__.\nBy using this endpoint, you are able to retrieve the structure of a zettel before it is evaluated.\n\nFor example, to retrieve some data about this zettel you are currently viewing, just send a HTTP GET request to the endpoint ''/z/00001012053600''[^If [[authentication is enabled|00001010040100]], you must include the a valid [[access token|00001012050200]] in the ''Authorization'' header] with the query parameter ''parseonly'' (and other appropriate query parameter).\nFor example:\n```sh\n# curl 'http://127.0.0.1:23123/z/00001012053600?enc=sz&parseonly'\n(BLOCK (PARA (TEXT \"The \") (LINK-ZETTEL () \"00001012920000\" (TEXT \"endpoint\")) (TEXT \" to work with parsed metadata and content of a specific zettel is \") (LITERAL-INPUT () \"/z/{ID}\") (TEXT \", where \") ...\n```\n\nSimilar to [[retrieving an encoded zettel|00001012053500]], you can specify an [[encoding|00001012920500]] and state which [[part|00001012920800]] of a zettel you are interested in.\nThe same default values applies to this endpoint.\n\n=== HTTP Status codes\n; ''200''\n: Retrieval was successful, the body contains an appropriate data value.\n; ''400''\n: Request was not valid. \n  There are several reasons for this.\n  Maybe the zettel identifier did not consist of exactly 14 digits or ''enc'' / ''part'' contained illegal values.\n; ''403''\n: You are not allowed to retrieve data of the given zettel.\n; ''404''\n: Zettel not found.\n  You probably used a zettel identifier that is not used in the Zettelstore."))