ecommerce/customers

Retrieve Customers

Retrieve customers from any connected Ats software

get/ecommerce/customers/{id}

Path parameters

idstring required

id of the customer you want to retrieve.

Query parameters

remote_databoolean

Set to true to include data from the original Ats software.

Headers

x-connection-tokenstring required

The connection token

Response

emailstring nullable

The email of the customer

first_namestring nullable

The first name of the customer

last_namestring nullable

The last name of the customer

phone_numberstring nullable

The phone number of the customer

field_mappingsobject nullable

The custom field mappings of the object between the remote 3rd party & Panora

idstring nullable

The UUID of the customer

remote_idstring nullable

The remote ID of the customer in the context of the 3rd Party

remote_dataobject nullable

The remote data of the customer in the context of the 3rd Party

created_atstring nullable

The created date of the object

modified_atstring nullable

The modified date of the object

Example response

{
  "email": "joedoe@gmail.com",
  "first_name": "Joe",
  "last_name": "Doe",
  "phone_number": "+336666666",
  "addresses": [
    {
      "address_type": "PERSONAL",
      "street_1": "5th Avenue",
      "state": "New York",
      "city": "New York",
      "country": "United States of America"
    }
  ],
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "id_1",
  "remote_data": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "created_at": "2024-10-01T12:00:00Z",
  "modified_at": "2024-10-01T12:00:00Z"
}

Changes

Changed in 3 of the 18 revisions of this API.1111

    • removed the PERSONAL enum value from the addresses/items/address_type response property for the response status 200

      response-property-enum-value-removed

    • removed the WORK enum value from the addresses/items/address_type response property for the response status 200

      response-property-enum-value-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 87189baf7791118See the full diff
    • the response property addresses became nullable for the status 200

      response-property-became-nullable

    • the response property created_at became nullable for the status 200

      response-property-became-nullable

    • the response property email became nullable for the status 200

      response-property-became-nullable

    • the response property field_mappings became nullable for the status 200

      response-property-became-nullable

    • the response property first_name became nullable for the status 200

      response-property-became-nullable

    • the response property id became nullable for the status 200

      response-property-became-nullable

    • the response property last_name became nullable for the status 200

      response-property-became-nullable

    • the response property modified_at became nullable for the status 200

      response-property-became-nullable

    • the response property phone_number became nullable for the status 200

      response-property-became-nullable

    • the response property remote_data became nullable for the status 200

      response-property-became-nullable

    • the response property remote_id became nullable for the status 200

      response-property-became-nullable

    • added the required property addresses/items/address_type to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/city to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/country to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/owner_type to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/postal_code to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/state to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/street_1 to the response with the 200 status

      response-required-property-added

    • added the required property addresses/items/street_2 to the response with the 200 status

      response-required-property-added

    • endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog