# Download customers as JSON

**GET** `https://api.zoined.com/v2/download/customers.json?limit=1000&offset=0&customer_id=123k`

Endpoint: GET /v2/download/customers.json
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer token

## Query parameters:

  - `limit` (number)
    How many entries to return

  - `offset` (number)
    Which offset to return data from

  - `customer_id` (string)
    Returns data of customer based on the given id

## Response 200:

  - `200` (unknown)
    Request has been processed successfully.
**Headers**
- `Content-Type: application/json`

## Response 200 fields (application/json):

  - `customer_id` (string, required)
    Customer ID
    Example: 32

  - `customer_name` (string)
    Customer Name
    Example: John Smith

  - `customer_company` (string)
    Customer Company
    Example: Smith Industries

  - `customer_email` (string)
    Customer Email
    Example: john.smith@customer.customer

  - `customer_phone` (string)
    Customer Phone
    Example: +35811111111

  - `customer_address` (string)
    Customer Street Address
    Example: Mannerheimintie 1

  - `customer_zipcode` (string)
    Customer's Zip Code
    Example: 00100

  - `customer_city` (string)
    Customer City
    Example: Helsinki

  - `customer_country` (string)
    Customer Country
    Example: Finland

  - `account_number` (string)
    45 (string, optional) - Account number
    Example: 123

  - `vat_number` (string)
    9 (string, optional) - VAT Number
    Example: 12345678

  - `organisation_id` (string)
    Customer account store ID
    Example: 1

  - `salesperson_id` (string)
    Customer account sales person ID
    Example: 3

  - `creation_date` (string)
    Date when this customer was added to system (yyyy-mm-dd).
    Example: 2021-12-15

  - `subscribe_date` (string)
    Date when this customer subscribed newsletter (yyyy-mm-dd).
    Example: 2022-01-15

  - `unsubscribe_date` (string)
    Date when this customer unsubscribed newsletter (yyyy-mm-dd).
    Example: 2022-02-15

  - `register_date` (string)
    Date when this customer registered to system (yyyy-mm-dd).
    Example: 2022-01-10

  - `unregister_date` (string)
    Date when this customer unregistered from system (yyyy-mm-dd).
    Example: 2022-03-15

  - `custom_dimension_1` (string)
    Custom Field 1
    Example: Class 3

  - `custom_dimension_2` (string)
    Custom Field 2
    Example: Class 3

  - `custom_dimension_3` (string)
    Custom Field 3
    Example: Class 3

  - `custom_dimension_4` (string)
    Custom Field 4
    Example: Class 3

  - `custom_dimension_5` (string)
    Custom Field 5
    Example: Class 3

  - `custom_dimension_6` (string)
    Custom Field 6
    Example: Class 3

  - `custom_dimension_7` (string)
    Custom Field 7
    Example: Class 3

  - `custom_dimension_8` (string)
    Custom Field 8
    Example: Class 3

  - `custom_dimension_9` (string)
    Custom Field 9
    Example: Class 3

  - `custom_dimension_10` (string)
    Custom Field 10
    Example: Class 3

  - `custom_dimension_11` (string)
    Custom Field 11
    Example: Class 3

  - `custom_dimension_12` (string)
    Custom Field 12
    Example: Class 3

  - `custom_dimension_13` (string)
    Custom Field 13
    Example: Class 3

  - `custom_dimension_14` (string)
    Custom Field 14
    Example: Class 3

  - `custom_dimension_15` (string)
    Custom Field 15
    Example: Class 3

  - `custom_dimension_16` (string)
    Custom Field 16
    Example: Class 3

  - `custom_dimension_17` (string)
    Custom Field 17
    Example: Class 3

  - `custom_dimension_18` (string)
    Custom Field 18
    Example: Class 3

  - `custom_dimension_19` (string)
    Custom Field 19
    Example: Class 3

  - `custom_dimension_20` (string)
    Custom Field 20
    Example: Class 3

  - `custom_dimension_21` (string)
    Custom Field 21
    Example: Class 3

  - `custom_dimension_22` (string)
    Custom Field 22
    Example: Class 3

  - `custom_dimension_23` (string)
    Custom Field 23
    Example: Class 3

  - `custom_dimension_24` (string)
    Custom Field 24
    Example: Class 3

  - `custom_dimension_25` (string)
    Custom Field 25
    Example: Class 3

  - `custom_dimension_26` (string)
    Custom Field 26
    Example: Class 3

  - `custom_dimension_27` (string)
    Custom Field 27
    Example: Class 3

  - `custom_dimension_28` (string)
    Custom Field 28
    Example: Class 3

  - `custom_dimension_29` (string)
    Custom Field 29
    Example: Class 3

  - `custom_dimension_30` (string)
    Custom Field 30
    Example: Class 3

  - `custom_dimension_31` (string)
    Custom Field 31
    Example: Class 3

  - `custom_dimension_32` (string)
    Custom Field 32
    Example: Class 3

  - `custom_dimension_33` (string)
    Custom Field 33
    Example: Class 3

  - `custom_dimension_34` (string)
    Custom Field 34
    Example: Class 3

  - `custom_dimension_35` (string)
    Custom Field 35
    Example: Class 3

  - `custom_dimension_36` (string)
    Custom Field 36
    Example: Class 3

  - `custom_dimension_37` (string)
    Custom Field 37
    Example: Class 3

  - `custom_dimension_38` (string)
    Custom Field 38
    Example: Class 3

  - `custom_dimension_39` (string)
    Custom Field 39
    Example: Class 3

  - `custom_dimension_40` (string)
    Custom Field 40
    Example: Class 3

  - `custom_dimension_41` (string)
    Custom Field 41
    Example: Class 3

  - `custom_dimension_42` (string)
    Custom Field 42
    Example: Class 3

  - `custom_dimension_43` (string)
    Custom Field 43
    Example: Class 3

  - `custom_dimension_44` (string)
    Custom Field 44
    Example: Class 3

  - `custom_dimension_45` (string)
    Custom Field 45
    Example: Class 3

  - `custom_dimension_46` (string)
    Custom Field 46
    Example: Class 3

  - `custom_dimension_47` (string)
    Custom Field 47
    Example: Class 3

  - `custom_dimension_48` (string)
    Custom Field 48
    Example: Class 3

  - `custom_dimension_49` (string)
    Custom Field 49
    Example: Class 3

  - `custom_dimension_50` (string)
    Custom Field 50
    Example: Class 3

  - `custom_metric_1` (number)
    Custom metric 1
    Example: 1

  - `custom_metric_2` (number)
    Custom metric 2
    Example: 100

  - `custom_metric_3` (number)
    Custom metric 3
    Example: 2.2

  - `custom_metric_4` (number)
    Custom metric 4
    Example: 1.05

  - `custom_metric_5` (number)
    Custom metric 5
    Example: 10000

## Response 400:

  - `400` (unknown)
    Invalid or malformed request.
**Headers**
- `Content-Type: application/json`

## Response 400 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Reason for error

## Response 401:

  - `401` (unknown)
    Missing or invalid authorization token in header
**Headers**
- `Content-Type: application/json`

## Response 401 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Unauthorized

## Response 500:

  - `500` (unknown)
    Internal error or exception
**Headers**
- `Content-Type: application/json`

## Response 500 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Reason for error

## Response 200 examples:

  - `response` (unknown)

## Response 400 examples:

  - `response` (unknown)

## Response 401 examples:

  - `response` (unknown)

## Response 500 examples:

  - `response` (unknown)

