CEAM Countries of Affiliation

Create a new CEAM Country of Affiliation

post/api/ceam-residences

Request

  • Base URL: https://hellosafe.com
  • URL: https://hellosafe.com/api/ceam-residences
  • Auth: OAuth 2 (password, token URL /api//openapi-auth)

Query parameters

depthnumber
localestring

Request body

namestring required

Internal name (English). Displayed names come from Intl.DisplayNames.

slugstring required

URL slug, English, kebab-case (e.g. "france").

isoCodestring required

ISO 3166-1 alpha-2 of the country of affiliation (FR, BE, DE…)

currencystring required

ISO 4217 of the reimbursing country (EUR, CHF…)

visibility'public' | 'hidden' nullable
bodyNamestring required

The body, named precisely — "le CNSE (Centre national des soins à l'étranger)", "votre mutualité", "votre Krankenkasse". Never just "social security". LOCALIZED: the front injects it mid-sentence ("C'est {body} qui vous rembourse"), so write it sentence-ready in each language — lowercase article first, descriptor in parentheses.

centralisedBodyboolean nullable

One national desk instructs every foreign-care file (FR: the CNSE). Unchecked means each local fund handles its own — the main driver of how long it takes.

liaisonBodystring nullable

Body that talks to foreign institutions (CLEISS, DVKA…)

onSiteRefundPossibleboolean nullable

Article 25(4): the traveler can claim from the institution of the place of stay, during the stay. Almost always the fastest route — worth surfacing before anything else.

bodyNotestring nullable
verifiedAtstring required

Last time the data was verified against sources

sourceFilestring nullable
internalNotesstring nullable
deletedAtstring nullable

Response

CEAM Country of Affiliation object

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.