# Get the currently authenticated merchant's IPS onboarding status

`GET https://api.leapa.co/v2/ips/onboard-merchant/status`

Self-service counterpart of the admin status endpoint — resolves the merchant from the bearer token. Gate consumers (payment widget, merchant portal) should key on the computed `onboarded` field. Latency-optimized: a locally recorded successful onboarding answers without the live Central Bank lookup; only unproven merchants pay for the CAS round-trip.

Send your API key as a bearer token in the `Authorization` header.

## Response 200

- `merchant_id` · _string_
- `onboarded` · _boolean_
- `local_status` · _string_
  Allowed values: `success`, `partial`, `failed`
- `ips_customer_id` · _string_
- `ips_alias_id` · _string_
- `ips_account_id` · _string_
- `ips_account_id_test` · _string_
- `mobile` · _string_
- `leapa_balance_account_id` · _string_
- `last_error` · _string_
- `cas_customer_exists` · _boolean_
- `cas_customer_status` · _string_
- `cas_record_id` · _string_
- `cas_alias_count` · _integer<int32>_
- `cas_account_count` · _integer<int32>_

```json
{
  "merchant_id": "mer_1b47d0e9ca",
  "onboarded": false,
  "local_status": "success",
  "ips_customer_id": "cus_3d8e51fa20",
  "ips_alias_id": "+25779123456",
  "ips_account_id": "acc_62f3a8d15b",
  "ips_account_id_test": "00012345678901",
  "mobile": "string",
  "leapa_balance_account_id": "acc_62f3a8d15b",
  "last_error": "string",
  "cas_customer_exists": false,
  "cas_customer_status": "string",
  "cas_record_id": "string",
  "cas_alias_count": 0,
  "cas_account_count": 0
}
```

## Status codes

- `200` OK
- `400` Bad request
- `401` Unauthorized
- `402` Payment required
- `403` Forbidden
- `404` Not found
- `428` Precondition required
- `500` Server error

## Example

```bash
curl -X GET "https://api.leapa.co/v2/ips/onboard-merchant/status" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Accept: application/json"
```

---

_Generated from the Leapa documentation at leapa.co/docs._