> Agent-readable docs index: /llms.txt. Fetch only the needed Markdown pages first; use /docs.zip only for broad search after checking /docs-manifest.json or /docs.zip.sha256.

# Client

This is the API for Clients.

It provides features for querying Clients, querying duplicate Clients, searching Clients, and retrieving and submitting first-visit questionnaires.

<details>
<summary>Key Concepts</summary>
<dl>
<dt>Client</dt>
<dd><strong>Definition:</strong> Customer information for a person who visits or makes a reservation at the clinic.<br /><strong>Description:</strong> Lookup and search are performed based on information such as name, phone number, chart number, date of birth, gender, and nationality.</dd>
<dt>Client ID</dt>
<dd><strong>Definition:</strong> A unique ID that identifies a Client.<br /><strong>Description:</strong> Used to link data from other domains, such as reservations, payments, treatment tickets, and prepaid cards, to a specific Client.</dd>
<dt>Duplicate Client</dt>
<dd><strong>Definition:</strong> An existing Client candidate who may be the same person.<br /><strong>Description:</strong> Used to check whether a Client has already been registered, based on criteria such as name, phone number, passport information, date of birth, and SNS information.</dd>
<dt>First-Visit Questionnaire</dt>
<dd><strong>Definition:</strong> Questionnaire information filled out by a Client before their first visit.<br /><strong>Description:</strong> Use the questionnaire retrieval API to check the form fields, and the submission API to submit the Client's responses.</dd>
<dt>Integration Information</dt>
<dd><strong>Definition:</strong> Linked information used to identify a Client from an external channel.<br /><strong>Description:</strong> User information from channels such as LINE and UNNI can be linked to a Client for use in duplicate checks or reservation creation.</dd>
<dt>Marketing Communication Consent</dt>
<dd><strong>Definition:</strong> Consent information related to whether a Client agrees to receive marketing communications.<br /><strong>Description:</strong> In the public API, marketing communication consent can be withdrawn based on phone number.</dd>
</dl>
</details>


## Endpoints

- [Unsubscribe from marketing communications](/en/docs/openapi/disable-advertising-agreement-to-visitors.md): `POST /visitor/open/v1/commands/disable-advertising-agreement-to-visitors`
- [Submit first-visit questionnaire for Client](/en/docs/openapi/submit-visitor-questionnaire.md): `POST /visitor/open/v1/commands/submit-visitor-questionnaire`
- [Look Up Already Registered Client ID](/en/docs/openapi/find-duplicated-visitor-id.md): `POST /visitor/open/v1/queries/find-duplicated-visitor-id`
- [Get first-visit questionnaire agreement items](/en/docs/openapi/get-questionnaire-agreements.md): `POST /visitor/open/v1/queries/get-questionnaire-agreements`
- [Retrieve submitted first-visit questionnaire](/en/docs/openapi/get-questionnaire-submit.md): `POST /visitor/open/v1/queries/get-questionnaire-submit`
- [Retrieve first-visit questionnaire for Client](/en/docs/openapi/get-visitor-questionnaire.md): `POST /visitor/open/v1/queries/get-visitor-questionnaire`
- [Search Client Information](/en/docs/openapi/search-visitors.md): `POST /visitor/open/v1/queries/search-visitors`
- [Search Clients](/en/docs/openapi/find-visitor.md) deprecated: `POST /visitor/open/v1/queries/find-visitor`