---
title: Bridging the two platforms
slug: bridging-the-two-platforms
createdAt: 2026-11-02T08:43:12.820Z
---

The only join between the two systems is the <font color="#EF4444">`organization_id`</font> returned by the legacy customer list.

<font color="#EF4444">`GET https://api.fsflt.net/customerarea/customers/list`</font>

Optional parameter: <font color="#EF4444">`customer_code`</font> — as a distributor, returns the customers of that specific customer.

```curl
curl 'https://api.fsflt.net/customerarea/customers/list' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_LEGACY_API_KEY'
```

```json
{
  "code": 200,
  "content": [
    {
      "main": false,
      "code": 12345,
      "name": "Mario",
      "surname": "Rossi",
      "email": "customer@example.com",
      "lang": "IT",
      "country_code": "IT",
      "company_name": "Rossi Srl",
      "industry_code": 1,
      "organization_id": "019f88ef-7fb5-725c-88e8-0d7028d1b392",
      "migration_status": "MIGRATED",
      "contacts": { "skype": "", "phone": "+390212345678" }
    }
  ]
}
```

| **Field**                                       | **Meaning**                                                                                                                             |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#EF4444">`organization_id`</font>  | The customer's identifier **on the new platform**. <font color="#EF4444">`null`</font> if the customer is not yet provisioned/migrated  |
| <font color="#EF4444">`migration_status`</font> | <font color="#EF4444">`MIGRATED`</font> · <font color="#EF4444">`NOT_MIGRATED`</font>· <font color="#EF4444">`MIGRATION_STARTED`</font> |

**Routing rule:**

- <font color="#EF4444">`organization_id`</font> **present** → the tenant exists on the Cloud Panel: configure policies and networks there, using that UUID as <font color="#EF4444">`organizationId`</font>.
- <font color="#EF4444">`organization_id`</font> **null** → the tenant is not (yet) available on the Cloud Panel: keep using <font color="#EF4444">`customer_code`</font> and retry later — it may simply still be provisioning.
- Never attempt to use <font color="#EF4444">`customer_code`</font>as <font color="#EF4444">`organizationId`</font> (or vice versa): different type, different platform.

:::hint{type="info"}
Once the customer is created, it is **automatically migrated to the new platform**, and this happens in the background: it can take a few seconds. As a consequence, <font color="#EF4444">`GET /customerarea/customers/list`</font> may return <font color="#EF4444">`organization_id: null`</font> for a short while even though the tenant is already being provisioned. Poll the endpoint (e.g. 5 attempts with backoff over \~60 s) until the UUID appears, instead of treating a <font color="#EF4444">`null`</font> value as a permanent "legacy-only" state.
:::

