---
title: "Find Client by Name"
method: GET
path: "/clients/find-by-name.json"
tags: ["Clients"]
---

# Find Client by Name

`GET /clients/find-by-name.json`

Returns a specific client.

## Query parameters

- `client_name` string, required
- `api_key` string, required

## Response `200`

SUCCESS.

- ClientsGetResponse
  - `client` object
    - `id` integer
    - `name` string
    - `code` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `language` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `email` string, nullable
    - `address` string, nullable — No enforced character limit (text column).
    - `city` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `postal_code` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `fiscal_id` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `website` string, nullable
    - `country` string, nullable — Maximum length is the database default, not an enforced business rule.
    - `phone` string, nullable
    - `fax` string, nullable
    - `preferred_contact` object — May be an empty object when no preferred contact is set.
      - `name` string, nullable — Contact-level name has no length validation, unlike the client-level `name` (max 100); the limit shown is the database default.
      - `email` string, nullable — Contact-level email allows one character more than the client-level `email` (max 254).
      - `phone` string, nullable — Contact-level phone has no length validation, unlike the client-level `phone` (max 20); the limit shown is the database default.
      - `mobile` string, nullable — Digits only (4-14). Validated against /\A\d{4,14}\z/.
    - `observations` string, nullable — No enforced character limit (text column).
    - `open_account_link` string
    - `send_options` integer, nullable
    - `payment_days` integer, nullable
    - `tax_exemption_code` string, nullable — Maximum length is the database default, not an enforced business rule.

## Other responses

- `401` — ACCESS DENIED
- `404` — NOT FOUND

## Changes

- **2026-08-25** `5b82d4eb0d9f` — 20 breaking, 1 warning, 3 info
  - the response property `client/address` became nullable for the status `200`
  - the response property `client/city` became nullable for the status `200`
  - the response property `client/country` became nullable for the status `200`
  - the response property `client/email` became nullable for the status `200`
  - …20 more

[Change history](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/changes/clients/find-by-name.json/get.md)

---

[API](https://skmtc.dev/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/revisions/59bc808e8784/schema)