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

# Migration

Banks can migrate existing customers to Peere in batches. Providers can do the same for merchants.

## Migrating Customers (Banks)

Send a `POST` to `/v1/bank/customers` with an array of customer objects.

```json theme={null}
{
  "customers": [
    {
      "clientRef": "CUST001",
      "firstname": "John",
      "lastname": "Doe",
      "accountName": "John Doe",
      "email": "john.doe@example.com",
      "country": "NG",
      "accountNumber": "1234567890",
      "reference": "ACC001"
    }
  ]
}
```

The response includes a `batchId`, a processing `status`, and a `summary` with counts for successful, failed, and duplicate records. For batches over a certain size, failures are returned as a downloadable CSV rather than inline.

After migration, link customer devices using `POST /v1/bank/customer/device/link` to enable merchant discovery.

## Migrating Merchants (Providers)

Send a `POST` to `/v1/provider/merchants` with an array of merchant objects. After creation, set appropriate trust levels for each merchant via `PATCH /v1/provider/merchant/trust`.

Migrate in batches of 100 or fewer and add a short delay between requests to avoid rate limits.