# Get a customer

Returns one customer (vendor) with its addresses, integration links and shipping preferences.

Endpoint: GET /v1/vendors/{vendorGuid}
Version: 1.19
Security: ApiKey, ApiSecret, UserGuid, UserToken, SupplierGuid

## Security:

  - `ApiKey` (unknown)
    apiKey in header x-apiKey

  - `ApiSecret` (unknown)
    apiKey in header x-apiSecret

  - `UserGuid` (unknown)
    apiKey in header userGuid

  - `UserToken` (unknown)
    apiKey in header userToken

  - `SupplierGuid` (unknown)
    apiKey in header supplierGuid

## Path parameters:

  - `vendorGuid` (string, required)
    GUID of the customer (vendor).

## Response 200:

  - `200` (unknown)
    The customer.

## Response 200 fields (application/json):

  - `id` (integer)

  - `guid` (string)

  - `supplier_id` (integer)

  - `parent_vendor_id` (integer)

  - `customer_internal_id` (string)
    Your own identifier for this customer.

  - `name` (string)

  - `email` (string)

  - `shipping_email` (string)

  - `phone` (string)

  - `cell` (string)

  - `fax` (string)

  - `address_line_one` (string)

  - `address_line_two` (string)

  - `city` (string)

  - `state` (string)

  - `postal_code` (string)

  - `country` (string)

  - `active` (boolean)

  - `tax_exempt` (boolean)

  - `resale_tax_id` (string)

  - `lock_catalog_id` (integer)
    When set, the customer can only order from this catalog.

  - `price_group_id` (integer)
    Price group used for this customer's pricing.

  - `payment_type_id` (integer)

  - `payment_term_id` (integer)

  - `require_payment` (boolean)

  - `credit_limit` (number)

  - `open_balance` (number)

  - `is_ecomm_user` (boolean)
    True for Orderwerks Online (e-commerce) customers.

  - `net_term_ecomm_user` (boolean)

  - `require_po` (boolean)

  - `standing_po` (string)

  - `hide_pricing` (boolean)

  - `currency_id` (integer)

  - `notes` (string)

  - `default_order_category_id` (integer)

  - `route_id` (integer)

  - `route_stop_order` (integer)
    Standing stop order of the customer on its route; null = unordered (sorts last, by name).

  - `timezone` (string)

  - `bill_to_id` (integer)

  - `ship_to_id` (integer)

  - `Bill_To` (object)
    A billing or shipping address. Additional internal fields may be present.

  - `Bill_To.id` (integer)

  - `Bill_To.guid` (string)

  - `Bill_To.vendor_id` (integer)

  - `Bill_To.order_id` (integer)

  - `Bill_To.name` (string)
    Contact name at this address.

  - `Bill_To.company_name` (string)

  - `Bill_To.address_line_one` (string)

  - `Bill_To.address_line_two` (string)

  - `Bill_To.address_line_three` (string)

  - `Bill_To.city` (string)

  - `Bill_To.state` (string)

  - `Bill_To.postal_code` (string)

  - `Bill_To.country` (string)

  - `Bill_To.phone` (string)

  - `Bill_To.fax` (string)

  - `Bill_To.email` (string)

  - `Bill_To.note` (string)

  - `Bill_To.address_internal_id` (string)
    Your own identifier for this address, if one was supplied.

  - `Bill_To.is_vendor_main_ship_to` (boolean)

  - `Bill_To.verified` (boolean)
    True when the address was verified against a postal database.

  - `Bill_To.lat` (number)

  - `Bill_To.lng` (number)

  - `Bill_To.created_at` (string)

  - `Bill_To.updated_at` (string)

  - `created_at` (string)

  - `updated_at` (string)

  - `deleted_at` (string)
    Present only in delta-sync responses for soft-deleted customers.

## Response 400:

  - `400` (unknown)
    The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).

## Response 400 fields (application/json):

  - `message` (string, required)
    Human-readable error message.
    Example: Invalid Catalog GUID

  - `error` (string)
    Underlying error detail, when available.

  - `code` (string)
    Machine-readable code for specific failures (for example `INVALID_DELTA_CURSOR`).

## Response 401:

  - `401` (unknown)
    Missing or invalid credentials.

## Response 401 fields (application/json):

  - `message` (string, required)
    Human-readable error message.
    Example: Invalid Catalog GUID

  - `error` (string)
    Underlying error detail, when available.

  - `code` (string)
    Machine-readable code for specific failures (for example `INVALID_DELTA_CURSOR`).

## Response 403:

  - `403` (unknown)
    The credentials are valid but the user lacks the access level this endpoint requires.

## Response 403 fields (application/json):

  - `message` (string, required)
    Human-readable error message.
    Example: Invalid Catalog GUID

  - `error` (string)
    Underlying error detail, when available.

  - `code` (string)
    Machine-readable code for specific failures (for example `INVALID_DELTA_CURSOR`).

## Response 404:

  - `404` (unknown)
    No resource with that GUID is visible to the authenticated supplier.

## Response 404 fields (application/json):

  - `message` (string, required)
    Human-readable error message.
    Example: Invalid Catalog GUID

  - `error` (string)
    Underlying error detail, when available.

  - `code` (string)
    Machine-readable code for specific failures (for example `INVALID_DELTA_CURSOR`).