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

# Find Client by Code

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

Returns a specific client.

## Query parameters

- `client_code` 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

---

[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/5b82d4eb0d9f/schema)