Accounts and Linking

Retrieve an account

GET /api/v1/accounts/{phone}

{
  "phone": "+228XXXXXXXX",
  "state": "claimed",
  "display_name": "Ama K.",
  "partners": [{ "code": "seed", "name": "SEED" }]
}

Link / invite

POST /api/v1/accounts/link

{
  "phone": "+228XXXXXXXX",
  "invite": true
}

Creates or retrieves the account, links it to your partner organization, and can send an SMS invitation so the user can claim MorisBox.

Provider fields

Partners can require custom fields during linking (for example, an insured-person number):

Endpoint	Purpose
GET /api/v1/settings/account-fields	List field definitions
POST /api/v1/settings/account-fields	Create a field
PATCH /api/v1/settings/account-fields/{id}	Update a field
DELETE /api/v1/settings/account-fields/{id}	Delete a field

Field types include char, date, selection, and others.

E2E keys (optional)

GET /api/v1/keys/{phone} - device public keys for encrypted messaging when enabled.