# Låst period (/api/referens/settings-lockedperiod)

> Läs organisationens låsdatum för bokföringen via /3/settings/lockedperiod.

Resursen speglar Fortnox `/3/settings/lockedperiod` och har ett enda fält: slutdatumet för den senast låsta bokföringsperioden. Verifikationer med `TransactionDate` i en låst period avvisas med `409` av [`POST /3/vouchers`](/api/referens/vouchers).

Scopet är `settings`, inte `bookkeeping`. En integration som bara behöver låsdatumet behöver alltså inte åtkomst till bokföringen.

**Scope:** `settings` · <Plan min="ai_pro" />

## Endpoints [#endpoints]

| Metod och sökväg | Beskrivning |
|---|---|
| <Endpoint method="GET" path="/api/v1/3/settings/lockedperiod" /> | Hämta låsdatumet |

Bas-URL: `https://app.klirr.ai/api/v1`. Det finns ingen `PUT`; perioder låses i Klirr. Inga parametrar läses.

## Fält [#fält]

| Fält | Typ | Skrivskyddat | Beskrivning |
|---|---|---|---|
| `EndDate` | string | ja | Sista dag (`ÅÅÅÅ-MM-DD`) i den senast låsta perioden. **Utelämnas helt** när ingen period är låst. |

Kontrollera alltså om `EndDate` finns, inte om det är tomt.

## Hämta låsdatumet [#hämta-låsdatumet]

<Tabs groupId="lang" persist items={['curl','TypeScript']}>
<Tab value="curl">
```bash
curl https://app.klirr.ai/api/v1/3/settings/lockedperiod \
  -H "Authorization: Bearer <access_token>"
```
</Tab>
<Tab value="TypeScript">
```ts
const res = await fetch('https://app.klirr.ai/api/v1/3/settings/lockedperiod', {
  headers: { Authorization: 'Bearer <access_token>' },
});
const { LockedPeriod } = await res.json();
const lockedUntil: string | undefined = LockedPeriod.EndDate;
```
</Tab>
</Tabs>

Med en låst period:

```json
{ "LockedPeriod": { "EndDate": "2026-02-28" } }
```

Utan låst period:

```json
{ "LockedPeriod": {} }
```

## Fel [#fel]

Resursen har inga egna fel utöver `500` (`9000500`) om låset inte kunde läsas. Allmänna fel (401, 403, 429) beskrivs under [Felkoder](/api/felkoder).