> For the complete documentation index, see [llms.txt](https://docs.zwapgrid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zwapgrid.com/api-guide/accounting-api-guide/accounting-periods.md).

# Accounting Periods

Retrieve accounting periods (fiscal years) for a given consent.

## List accounting periods

> Retrieves a paginated list of accounting periods for the specified consent.\
> \
> \*\*System support\*\*\
> \
> \| System | Status |\
> \|---|---|\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/fortnox\\_20\\_20.svg>" alt="Fortnox" width="20" height="20" style="vertical-align:middle" /> Fortnox | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bjorn-lunden\\_20\\_20.svg>" alt="Bjorn Lunden" width="20" height="20" style="vertical-align:middle" /> Bjorn Lunden | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/spiris\\_20\\_20.svg>" alt="Spiris" width="20" height="20" style="vertical-align:middle" /> Spiris | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/tripletex\\_20\\_20.svg>" alt="Tripletex" width="20" height="20" style="vertical-align:middle" /> Tripletex | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-economic\\_20\\_20.svg>" alt="Visma e-conomic" width="20" height="20" style="vertical-align:middle" /> Visma e-conomic | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/billy\\_20\\_20.svg>" alt="Billy" width="20" height="20" style="vertical-align:middle" /> Billy | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-dinero\\_20\\_20.svg>" alt="Visma Dinero" width="20" height="20" style="vertical-align:middle" /> Visma Dinero | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/finago-procountor\\_20\\_20.png>" alt="Procountor" width="20" height="20" style="vertical-align:middle" /> Procountor | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-netvisor\\_20\\_20.svg>" alt="Visma Netvisor" width="20" height="20" style="vertical-align:middle" /> Visma Netvisor | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/business-central\\_20\\_20.svg>" alt="Microsoft Business Central" width="20" height="20" style="vertical-align:middle" /> Microsoft Business Central | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/exact-online\\_20\\_20.svg>" alt="Exact Online" width="20" height="20" style="vertical-align:middle" /> Exact Online | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/quickbooks\\_20\\_20.png>" alt="QuickBooks" width="20" height="20" style="vertical-align:middle" /> QuickBooks | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/xero\\_20\\_20.svg>" alt="Xero" width="20" height="20" style="vertical-align:middle" /> Xero | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bokio\\_20\\_20.svg>" alt="Bokio" width="20" height="20" style="vertical-align:middle" /> Bokio | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/kleer\\_20\\_20.svg>" alt="Kleer" width="20" height="20" style="vertical-align:middle" /> Kleer | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/datev\\_20\\_20.svg>" alt="DATEV" width="20" height="20" style="vertical-align:middle" /> DATEV | ✅ Supported |

```json
{"openapi":"3.1.1","info":{"title":"Accounting API","version":"v1"},"tags":[{"name":"Accounting Periods","description":"Retrieve accounting periods (fiscal years) for a given consent."}],"servers":[{"url":"https://apione.zwapgrid.com/accounting"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Use the API key to access all API endpoints.","name":"x-api-key","in":"header"}},"schemas":{"AccountingPeriodDtoPagedResultDto":{"type":"object","properties":{"meta":{"description":"Pagination metadata for the result set.","$ref":"#/components/schemas/PagedResultMetadataDto"},"data":{"type":["null","array"],"items":{"description":"Represents an accounting period (fiscal year or sub-period).","$ref":"#/components/schemas/AccountingPeriodDto"},"description":"Collection of items in the current page."}},"additionalProperties":false,"description":"Represents a paginated result containing metadata and a collection of items."},"PagedResultMetadataDto":{"type":"object","properties":{"totalResources":{"type":["null","integer"],"description":"Total number of resources across all pages.","format":"int32"},"totalPages":{"type":["null","integer"],"description":"Total number of pages available.","format":"int32"},"currentPage":{"type":"integer","description":"The current page number.","format":"int32"}},"additionalProperties":false,"description":"Represents pagination metadata for a paged result set."},"AccountingPeriodDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier generated by the accounting system."},"reference":{"type":["null","string"],"description":"External reference or number assigned to the accounting period."},"accountingMethod":{"type":["null","string"],"description":"Accounting method used during the period (null if not available)."},"startDate":{"type":["null","string"],"description":"Date when the accounting period starts. Format: yyyy-MM-dd."},"endDate":{"type":["null","string"],"description":"Date when the accounting period ends. Format: yyyy-MM-dd."},"isOpen":{"type":["null","boolean"],"description":"Indicates whether the accounting period is currently open for transactions."}},"additionalProperties":false,"description":"Represents an accounting period (fiscal year or sub-period)."},"ProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"]},"title":{"type":["null","string"]},"status":{"type":["null","integer"],"format":"int32"},"detail":{"type":["null","string"]},"instance":{"type":["null","string"]}},"additionalProperties":{}},"ProviderRateLimitInformation":{"type":"object","properties":{"responseHeaders":{"type":["null","object"],"additionalProperties":{"type":"string"}}},"additionalProperties":false}}},"paths":{"/api/v1/consents/{consentId}/accountingperiods":{"get":{"tags":["Accounting Periods"],"summary":"List accounting periods","description":"Retrieves a paginated list of accounting periods for the specified consent.\n\n**System support**\n\n| System | Status |\n|---|---|\n| <img src=\"https://clients.zwapgrid.com/assets/logos/fortnox_20_20.svg\" alt=\"Fortnox\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Fortnox | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bjorn-lunden_20_20.svg\" alt=\"Bjorn Lunden\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bjorn Lunden | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/spiris_20_20.svg\" alt=\"Spiris\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Spiris | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/tripletex_20_20.svg\" alt=\"Tripletex\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Tripletex | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-economic_20_20.svg\" alt=\"Visma e-conomic\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma e-conomic | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/billy_20_20.svg\" alt=\"Billy\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Billy | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-dinero_20_20.svg\" alt=\"Visma Dinero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Dinero | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/finago-procountor_20_20.png\" alt=\"Procountor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Procountor | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-netvisor_20_20.svg\" alt=\"Visma Netvisor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Netvisor | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/business-central_20_20.svg\" alt=\"Microsoft Business Central\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Microsoft Business Central | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/exact-online_20_20.svg\" alt=\"Exact Online\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Exact Online | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/quickbooks_20_20.png\" alt=\"QuickBooks\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> QuickBooks | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/xero_20_20.svg\" alt=\"Xero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Xero | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bokio_20_20.svg\" alt=\"Bokio\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bokio | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/kleer_20_20.svg\" alt=\"Kleer\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Kleer | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/datev_20_20.svg\" alt=\"DATEV\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> DATEV | ✅ Supported |","operationId":"ListAccountingPeriods","parameters":[{"name":"consentId","in":"path","description":"Identifier of the consent representing the connection to the accounting system.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"x-correlation-id","in":"header","description":"Unique identifier used to correlate and trace this request.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Returns a paginated list of accounting periods for the specified consent.","content":{"application/json":{"schema":{"description":"Represents a paginated result containing metadata and a collection of items.","$ref":"#/components/schemas/AccountingPeriodDtoPagedResultDto"}}}},"401":{"description":"Missing or invalid authentication credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"Not authorized to access this resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"The requested accounting periods were not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"The request was rate-limited. The response may include Retry-After and ErpError.responseHeaders with retry and quota information from the accounting system.","headers":{"Retry-After":{"description":"Delay in seconds or an HTTP date supplied by the accounting system. Wait until this interval has elapsed before retrying. Optional; availability depends on the integration.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"ErpError":{"$ref":"#/components/schemas/ProviderRateLimitInformation"}}}]}}}},"501":{"description":"This operation is not supported by the connected accounting system.","content":{"application/json":{}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.zwapgrid.com/api-guide/accounting-api-guide/accounting-periods.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
