> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qonto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate to GET /v2/organization

> Move off the deprecated /v1/organizations/{slug} and /v2/organizations/{slug} endpoints before their sunset on September 15, 2026.

<Warning>
  `GET /v1/organizations/{slug}` and `GET /v2/organizations/{slug}` will be sunset on **September 15, 2026**.
  Migrate to `GET /v2/organization` before that date.
</Warning>

## What is changing

Both deprecated endpoints already emit `Sunset`, `Deprecation`, and `Link` response headers so well-behaved clients can detect the upcoming retirement programmatically. After **September 15, 2026** both endpoints will respond with `410 Gone`.

## Who is affected

Any integration calling either of the following URLs:

* `GET /v1/organizations/{slug}`
* `GET /v2/organizations/{slug}`

## Feature parity

`GET /v2/organization` is backed by the same handler as the deprecated routes, so it returns the same underlying data. The OAuth scope (`organization.read`) is unchanged.

There is one interface difference: the `{slug}` path parameter is removed. Your OAuth token already identifies the organization, so the URL slug was effectively redundant — the gateway always resolved requests to the authenticated organization regardless of what you passed in the path.

<Info>
  The slug is still returned in the response body at `organization.slug`, so any client code that reads the slug keeps working.
</Info>

## Step-by-step migration

<Steps>
  <Step title="Swap the URL">
    Replace `/v1/organizations/{slug}` or `/v2/organizations/{slug}` with `/v2/organization` and drop the slug from the path. The response is resolved from the authenticated organization.
  </Step>

  <Step title="Keep the same OAuth scope">
    `organization.read` — unchanged.
  </Step>

  <Step title="Read the slug from the response if you still need it">
    `organization.slug` remains in the response body.
  </Step>

  <Step title="(Optional) Adopt the richer v2 response">
    `GET /v2/organization` also exposes extra fields (`id`, `name`, `locale`, `legal_*`, `contract_signed_at`, additional bank-account fields) and an optional `include_external_accounts` query parameter. None of this is required — ignore fields you don't need.
  </Step>

  <Step title="Watch the deprecation signals">
    Until the cutover, monitor the `Sunset`, `Deprecation`, and `Link` response headers on the deprecated endpoints to automate migration reminders in your infrastructure.
  </Step>
</Steps>

## Before / after

<Tabs>
  <Tab title="Before (v1 or v2 slug)">
    ```bash theme={null}
    curl -H "Authorization: Bearer $TOKEN" \
      https://thirdparty.qonto.com/v1/organizations/$SLUG

    # or

    curl -H "Authorization: Bearer $TOKEN" \
      https://thirdparty.qonto.com/v2/organizations/$SLUG
    ```
  </Tab>

  <Tab title="After (v2 target)">
    ```bash theme={null}
    curl -H "Authorization: Bearer $TOKEN" \
      https://thirdparty.qonto.com/v2/organization
    ```
  </Tab>
</Tabs>

## Response headers on the deprecated endpoints

Until the sunset date, every response from the deprecated endpoints includes:

```http theme={null}
Sunset: Tue, 15 Sep 2026 23:59:59 GMT
Deprecation: @1789495199
Link: <https://docs.qonto.com/api-reference/business-api/accounts-organizations/organizations/migrate-from-deprecated-organization-endpoints>; rel="deprecation",
      <https://thirdparty.qonto.com/v2/organization>; rel="successor-version"
```

These follow [RFC 8594](https://www.rfc-editor.org/rfc/rfc8594.html) (`Sunset`) and [RFC 9745](https://www.rfc-editor.org/rfc/rfc9745.html) (`Deprecation`).

## Timeline

* **Today:** deprecated endpoints return the new `Sunset` / `Deprecation` / `Link` headers and continue to serve `200 OK`.
* **September 15, 2026:** deprecated endpoints return `410 Gone`.

## Related

* [GET /v2/organization](/api-reference/business-api/accounts-organizations/organizations/retrieve-the-authenticated-organization-and-list-bank-accounts)
* [Versioning](/get-started/general/versioning)