> For the complete documentation index, see [llms.txt](https://docs.devland.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devland.is/products/postholf.md).

# Pósthólfið

## Getting started

* Request access to the mailbox (í. Pósthólfið). You can apply for access to the mailbox at island.is' application site <https://island.is/postholf/stofnanir.\\>
  The application has to include information about the institution that is applying as well as information about the guarantor (í. ábyrgðaraðili) and technical point of contact.
* If the application is accepted, the technical point of contact will receive the following information:
  * ClientId / ClientSecret - To be able to use the Skjalatilkynning API
  * Audience
  * Scope
* The applicant needs to implement an executable that delivers document references to the mailbox by calling [Skjalatilkynning API](https://github.com/island-is/island.is/blob/main/handbook/technical-overview/postholf/postholf-03-interface-skjalatilkynning.md). An example can be seen in the Keyrsla section in the following link: <https://github.com/digitaliceland/postholf-demo>
* The applicant has to implement a callback service that returns a document when it's requested by the user. The service has to be implemented according to the [Skjalaveita API interface](/products/postholf/postholf-03-interface-skjalaveita.md). Example: <https://github.com/digitaliceland/postholf-demo>
* Information must be sent to Stafrænt Ísland regarding where (url) to call the aforementioned service.

## Content

* [Security Checklist](/products/postholf/postholf-00-security-checklist.md)
* [Introduction](/products/postholf/postholf-01-intro-and-overview.md)
* [Skjalatilkynning API](/products/postholf/postholf-02-interface-skjalatilkynning.md)
* [Skjalaveita API](/products/postholf/postholf-03-interface-skjalaveita.md)
* [Sequence Diagram](/products/postholf/postholf-04-sequence-diagram.md)
* [Interfaces](/products/postholf/postholf-05-interfaces.md)