External API

Customer Contacts

Endpointhttps://api.datavisual.ca

Customer contact records with storefront overlays

List customer contacts

GET

https://api.datavisual.ca

/v1/customer-contacts

Returns a paginated list of customer contacts for the authenticated customer. Returns canonical CRM contact data with storefront overlay values applied where present.

List customer contacts › query Parameters

limit

integer · min: 1 · max: 200

Default: 25

cursor

string

email

string

Filter by exact canonical CRM email

List customer contacts › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List customer contacts › Responses

Customer contacts

object[]

next_cursor

string | null

GET/v1/customer-contacts

curl --request GET \
  --url https://api.datavisual.ca/v1/customer-contacts \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "account_manager_name": "Jane Smith",
      "account_manager_email": "[email protected]",
      "full_name": "John Smith",
      "first_name": "John",
      "last_name": "Smith",
      "title": "Procurement Manager",
      "email": "[email protected]",
      "secondary_email": null,
      "phone": "6135550100",
      "mobile": "+16135550100",
      "extension": null,
      "web_portal_access": true,
      "language_preference": "ENGLISH",
      "is_primary_contact": true,
      "is_billing_contact": false,
      "region": "East"
    }
  ],
  "next_cursor": null
}

json

application/json

Get customer contact by ID

GET

https://api.datavisual.ca

/v1/customer-contacts/{id}

Returns a single customer contact for the authenticated customer. If the canonical CRM contact does not exist yet, the endpoint may temporarily return the storefront-backed pending record.

Get customer contact by ID › path Parameters

id

string · uuid · required

Get customer contact by ID › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get customer contact by ID › Responses

Customer contact

object

GET/v1/customer-contacts/{id}

curl --request GET \
  --url https://api.datavisual.ca/v1/customer-contacts/:id \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "account_manager_name": "Jane Smith",
    "account_manager_email": "[email protected]",
    "full_name": "John Smith",
    "first_name": "John",
    "last_name": "Smith",
    "title": "Procurement Manager",
    "email": "[email protected]",
    "secondary_email": null,
    "phone": "6135550100",
    "mobile": "+16135550100",
    "extension": null,
    "web_portal_access": true,
    "language_preference": "ENGLISH",
    "is_primary_contact": true,
    "is_billing_contact": false,
    "region": "East"
  }
}

json

application/json

Account Quotes

List customer contacts

GET

https://api.datavisual.ca

/v1/customer-contacts

Returns a paginated list of customer contacts for the authenticated customer. Returns canonical CRM contact data with storefront overlay values applied where present.

List customer contacts › query Parameters

limit

integer · min: 1 · max: 200

Default: 25

cursor

string

email

string

Filter by exact canonical CRM email

List customer contacts › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List customer contacts › Responses

Customer contacts

object[]

next_cursor

string | null

{ "data": [ { "id": "00000000-0000-0000-0000-000000000000", "account_manager_name": "Jane Smith", "account_manager_email": "[email protected]", "full_name": "John Smith", "first_name": "John", "last_name": "Smith", "title": "Procurement Manager", "email": "[email protected]", "secondary_email": null, "phone": "6135550100", "mobile": "+16135550100", "extension": null, "web_portal_access": true, "language_preference": "ENGLISH", "is_primary_contact": true, "is_billing_contact": false, "region": "East" } ], "next_cursor": null }

Get customer contact by ID

GET

https://api.datavisual.ca

/v1/customer-contacts/{id}

Returns a single customer contact for the authenticated customer. If the canonical CRM contact does not exist yet, the endpoint may temporarily return the storefront-backed pending record.

Get customer contact by ID › path Parameters

id

string · uuid · required

Get customer contact by ID › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get customer contact by ID › Responses

Customer contact

object

{ "data": { "id": "00000000-0000-0000-0000-000000000000", "account_manager_name": "Jane Smith", "account_manager_email": "[email protected]", "full_name": "John Smith", "first_name": "John", "last_name": "Smith", "title": "Procurement Manager", "email": "[email protected]", "secondary_email": null, "phone": "6135550100", "mobile": "+16135550100", "extension": null, "web_portal_access": true, "language_preference": "ENGLISH", "is_primary_contact": true, "is_billing_contact": false, "region": "East" } }