> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primulusgroup.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Clients

> Export zákazníků

## Sloupce odpovědi

Odpověď je CSV (`text/csv`). Sloupce jsou v tomto pořadí:

| Sloupec                            | Popis                                            |
| ---------------------------------- | ------------------------------------------------ |
| `client_id`                        | ID zákazníka                                     |
| `mutation_id`                      | ID mutace, ve které byl zákazník poprvé vytvořen |
| `company`                          | Firma                                            |
| `company_id_number`                | IČO                                              |
| `vat_number`                       | DIČ                                              |
| `last_name`                        | Příjmení zákazníka                               |
| `first_name`                       | Jméno zákazníka                                  |
| `street`                           | Ulice                                            |
| `city`                             | Město                                            |
| `postal_code`                      | PSČ                                              |
| `country`                          | Stát                                             |
| `phone_anonymized`                 | Anonymizovaný telefon (SHA-256)                  |
| `groups`                           | Skupiny zákazníka oddělené čárkou                |
| `email_anonymized`                 | Anonymizovaný e-mail (SHA-256)                   |
| `create_date_time`                 | Datum a čas vytvoření účtu zákazníka             |
| `registration_confirmed_date_time` | Datum a čas potvrzení registrace                 |
| `last_updated_at`                  | Timestamp poslední aktualizace záznamu zákazníka |


## OpenAPI

````yaml api-reference/openapi.json GET /clients
openapi: 3.1.0
info:
  title: WS API
  version: 1.0.0
  description: >-
    Read-only exportní API skupiny Primulus Group. Všechny endpointy jsou `GET`
    a vracejí data ve formátu CSV (`text/csv`). Autorizace probíhá povinným
    query parametrem `key`.
servers:
  - url: https://zeptej.se.it/api/csv/v1
    description: Produkční WS API v1
security:
  - apiKeyAuth: []
paths:
  /clients:
    get:
      tags:
        - Clients
      summary: Export zákazníků
      description: >-
        Export zákazníků. Obsahuje základní informace o zákazníkovi, kontaktní a
        fakturační údaje a statistiky objednávek.
      operationId: getClients
      parameters:
        - $ref: '#/components/parameters/mutation_id'
        - $ref: '#/components/parameters/create_date_from'
        - $ref: '#/components/parameters/create_date_to'
        - $ref: '#/components/parameters/last_updated_at_from'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/from_index'
      responses:
        '200':
          $ref: '#/components/responses/CsvExport'
components:
  parameters:
    mutation_id:
      name: mutation_id
      in: query
      required: false
      description: Seznam ID [mutací](/ciselniky/mutace) oddělených čárkou.
      schema:
        type: string
      example: '1'
    create_date_from:
      name: create_date_from
      in: query
      required: false
      description: Datum od (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2026-01-01'
    create_date_to:
      name: create_date_to
      in: query
      required: false
      description: Datum do (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2026-01-31'
    last_updated_at_from:
      name: last_updated_at_from
      in: query
      required: false
      description: Filtr na datum poslední změny (Unix timestamp).
      schema:
        type: integer
      example: 1735689600
    limit:
      name: limit
      in: query
      required: false
      description: Vlastní limit počtu záznamů místo výchozí hodnoty.
      schema:
        type: integer
      example: 100
    from_index:
      name: from_index
      in: query
      required: false
      description: >-
        Index prvního výsledku (první výsledek má index `0`). Kombinuje se s
        `limit`.
      schema:
        type: integer
      example: 0
  responses:
    CsvExport:
      description: Úspěšná odpověď. Tělo je export ve formátu CSV (`text/csv`).
      content:
        text/csv:
          schema:
            type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: key
      description: >-
        Autorizační klíč. Povinný ve všech endpointech. Vydá vám ho tým Primulus
        Group.

````