POST v1/Companies({CompanyId})/Search

This call returns Customers which match supplied criteria and is more versatile than the /CustomerSearch endpoint

Information:

Base URL:

https://api.covasoft.net/crm

Example of a call would be:

https://api{{en}}.covasoft.net/crm/v1/Companies({{CompanyId}})/Search

Request Information

URI Parameters

NameDescriptionTypeAdditional information
CompanyId

Company Id from your onboarding package

integer

Required

Body Parameters

CustomerSearchUsingMultipleExtensionsPost
NameDescriptionTypeAdditional information
Criteria

Collection of CustomerSearchCriteria

None.

Request Formats

application/json, text/json

Sample:
{
  "Criteria": [
    {
      "Criteria": "sample string 1",
      "Field": "sample string 2",
      "Operation": "sample string 3"
    },
    {
      "Criteria": "sample string 1",
      "Field": "sample string 2",
      "Operation": "sample string 3"
    }
  ]
}

Response Information

Resource Description

An Id, the CustomerSearchCriteria collection from the POST and a collection of CustomerFull records matching the search

CustomerSearchUsingMultipleExtensionsResult
NameDescriptionTypeAdditional information
Id

integer

None.

Criteria

Collection of CustomerSearchCriteria

None.

Results

Collection of CustomerFullReturn

None.

Response Formats

application/json, text/json

Sample:
{
  "Id": 1,
  "Criteria": [
    {
      "Criteria": "sample string 1",
      "Field": "sample string 2",
      "Operation": "sample string 3"
    },
    {
      "Criteria": "sample string 1",
      "Field": "sample string 2",
      "Operation": "sample string 3"
    }
  ],
  "Results": [
    {
      "Addresses": [
        {
          "AddressLine1": "sample string 1",
          "AddressLine2": "sample string 2",
          "City": "sample string 3",
          "StateName": "sample string 4",
          "CountryName": "sample string 5",
          "Zip": 1,
          "Id": "b4ef12f0-aa29-4c2b-a180-59a358cef889",
          "CustomerId": "cb45019b-744a-41fa-b2d7-86c6cddc7530",
          "AddressTypeId": 8,
          "AddressType": "sample string 9",
          "Default": true,
          "DoNotContact": true,
          "CountryCode": "sample string 12",
          "Country": "sample string 13",
          "Locality": "sample string 14",
          "StateCode": "sample string 15",
          "State": "sample string 16",
          "PostalCode": "sample string 17",
          "PostOfficeBoxNumber": "sample string 18",
          "StreetAddress1": "sample string 19",
          "Notes": "sample string 20",
          "StreetAddress2": "sample string 21",
          "Version": 22,
          "AttentionTo": "sample string 23",
          "Phone": "sample string 24",
          "Email": "sample string 25"
        },
        {
          "AddressLine1": "sample string 1",
          "AddressLine2": "sample string 2",
          "City": "sample string 3",
          "StateName": "sample string 4",
          "CountryName": "sample string 5",
          "Zip": 1,
          "Id": "b4ef12f0-aa29-4c2b-a180-59a358cef889",
          "CustomerId": "cb45019b-744a-41fa-b2d7-86c6cddc7530",
          "AddressTypeId": 8,
          "AddressType": "sample string 9",
          "Default": true,
          "DoNotContact": true,
          "CountryCode": "sample string 12",
          "Country": "sample string 13",
          "Locality": "sample string 14",
          "StateCode": "sample string 15",
          "State": "sample string 16",
          "PostalCode": "sample string 17",
          "PostOfficeBoxNumber": "sample string 18",
          "StreetAddress1": "sample string 19",
          "Notes": "sample string 20",
          "StreetAddress2": "sample string 21",
          "Version": 22,
          "AttentionTo": "sample string 23",
          "Phone": "sample string 24",
          "Email": "sample string 25"
        }
      ],
      "ContactMethods": [
        {
          "Value": "sample string 1",
          "Id": "8637e950-da48-4e6c-8d50-337be17d7fb5",
          "CustomerId": "db586306-5f8a-4bdf-a3fa-0967a96aa1d4",
          "ContactMethodCategoryId": 4,
          "ContactMethodCategory": "sample string 5",
          "ContactMethodTypeId": 6,
          "ContactMethodType": "sample string 7",
          "DoNotContact": true,
          "Default": true,
          "Notes": "sample string 10",
          "Version": 11
        },
        {
          "Value": "sample string 1",
          "Id": "8637e950-da48-4e6c-8d50-337be17d7fb5",
          "CustomerId": "db586306-5f8a-4bdf-a3fa-0967a96aa1d4",
          "ContactMethodCategoryId": 4,
          "ContactMethodCategory": "sample string 5",
          "ContactMethodTypeId": 6,
          "ContactMethodType": "sample string 7",
          "DoNotContact": true,
          "Default": true,
          "Notes": "sample string 10",
          "Version": 11
        }
      ],
      "CustomerExtensions": [
        {
          "Value": "sample string 1",
          "Id": "db74f9fc-ecdc-41e5-80d0-afaa377d6cb0",
          "CustomerId": "d917c090-9852-48c3-9ae9-871cb7e0304b",
          "ExtensionTypeId": 4,
          "ExtensionType": "sample string 5",
          "ExtensionTypeFeature": "sample string 6",
          "Version": 7
        },
        {
          "Value": "sample string 1",
          "Id": "db74f9fc-ecdc-41e5-80d0-afaa377d6cb0",
          "CustomerId": "d917c090-9852-48c3-9ae9-871cb7e0304b",
          "ExtensionTypeId": 4,
          "ExtensionType": "sample string 5",
          "ExtensionTypeFeature": "sample string 6",
          "Version": 7
        }
      ],
      "RelatedCustomers": [
        {},
        {}
      ],
      "MemberOf": [
        {},
        {}
      ],
      "Documents": [
        {},
        {}
      ],
      "MergedCustomers": [
        {},
        {}
      ],
      "PrimaryName": "sample string 1",
      "Title": "sample string 2",
      "AlternateName": "sample string 3",
      "MiddleName": "sample string 4",
      "FamilyName": "sample string 5",
      "ReferralSource": "sample string 6",
      "Notes": "sample string 7",
      "UniqueIdentifier": "sample string 8",
      "Id": "953aa6b2-a211-4481-b7cf-44b364d500c4",
      "CustomerTypeId": 10,
      "CustomerType": "sample string 11",
      "DateOfBirth": "2024-11-07T08:34:27.8641623+00:00",
      "PricingGroupId": 13,
      "Disabled": true,
      "DoNotContact": true,
      "Version": 16,
      "MergedIntoCustomerId": {},
      "LastModifiedDateUtc": "2024-11-07T08:34:27.8641623+00:00"
    },
    {
      "Addresses": [
        {
          "AddressLine1": "sample string 1",
          "AddressLine2": "sample string 2",
          "City": "sample string 3",
          "StateName": "sample string 4",
          "CountryName": "sample string 5",
          "Zip": 1,
          "Id": "b4ef12f0-aa29-4c2b-a180-59a358cef889",
          "CustomerId": "cb45019b-744a-41fa-b2d7-86c6cddc7530",
          "AddressTypeId": 8,
          "AddressType": "sample string 9",
          "Default": true,
          "DoNotContact": true,
          "CountryCode": "sample string 12",
          "Country": "sample string 13",
          "Locality": "sample string 14",
          "StateCode": "sample string 15",
          "State": "sample string 16",
          "PostalCode": "sample string 17",
          "PostOfficeBoxNumber": "sample string 18",
          "StreetAddress1": "sample string 19",
          "Notes": "sample string 20",
          "StreetAddress2": "sample string 21",
          "Version": 22,
          "AttentionTo": "sample string 23",
          "Phone": "sample string 24",
          "Email": "sample string 25"
        },
        {
          "AddressLine1": "sample string 1",
          "AddressLine2": "sample string 2",
          "City": "sample string 3",
          "StateName": "sample string 4",
          "CountryName": "sample string 5",
          "Zip": 1,
          "Id": "b4ef12f0-aa29-4c2b-a180-59a358cef889",
          "CustomerId": "cb45019b-744a-41fa-b2d7-86c6cddc7530",
          "AddressTypeId": 8,
          "AddressType": "sample string 9",
          "Default": true,
          "DoNotContact": true,
          "CountryCode": "sample string 12",
          "Country": "sample string 13",
          "Locality": "sample string 14",
          "StateCode": "sample string 15",
          "State": "sample string 16",
          "PostalCode": "sample string 17",
          "PostOfficeBoxNumber": "sample string 18",
          "StreetAddress1": "sample string 19",
          "Notes": "sample string 20",
          "StreetAddress2": "sample string 21",
          "Version": 22,
          "AttentionTo": "sample string 23",
          "Phone": "sample string 24",
          "Email": "sample string 25"
        }
      ],
      "ContactMethods": [
        {
          "Value": "sample string 1",
          "Id": "8637e950-da48-4e6c-8d50-337be17d7fb5",
          "CustomerId": "db586306-5f8a-4bdf-a3fa-0967a96aa1d4",
          "ContactMethodCategoryId": 4,
          "ContactMethodCategory": "sample string 5",
          "ContactMethodTypeId": 6,
          "ContactMethodType": "sample string 7",
          "DoNotContact": true,
          "Default": true,
          "Notes": "sample string 10",
          "Version": 11
        },
        {
          "Value": "sample string 1",
          "Id": "8637e950-da48-4e6c-8d50-337be17d7fb5",
          "CustomerId": "db586306-5f8a-4bdf-a3fa-0967a96aa1d4",
          "ContactMethodCategoryId": 4,
          "ContactMethodCategory": "sample string 5",
          "ContactMethodTypeId": 6,
          "ContactMethodType": "sample string 7",
          "DoNotContact": true,
          "Default": true,
          "Notes": "sample string 10",
          "Version": 11
        }
      ],
      "CustomerExtensions": [
        {
          "Value": "sample string 1",
          "Id": "db74f9fc-ecdc-41e5-80d0-afaa377d6cb0",
          "CustomerId": "d917c090-9852-48c3-9ae9-871cb7e0304b",
          "ExtensionTypeId": 4,
          "ExtensionType": "sample string 5",
          "ExtensionTypeFeature": "sample string 6",
          "Version": 7
        },
        {
          "Value": "sample string 1",
          "Id": "db74f9fc-ecdc-41e5-80d0-afaa377d6cb0",
          "CustomerId": "d917c090-9852-48c3-9ae9-871cb7e0304b",
          "ExtensionTypeId": 4,
          "ExtensionType": "sample string 5",
          "ExtensionTypeFeature": "sample string 6",
          "Version": 7
        }
      ],
      "RelatedCustomers": [
        {},
        {}
      ],
      "MemberOf": [
        {},
        {}
      ],
      "Documents": [
        {},
        {}
      ],
      "MergedCustomers": [
        {},
        {}
      ],
      "PrimaryName": "sample string 1",
      "Title": "sample string 2",
      "AlternateName": "sample string 3",
      "MiddleName": "sample string 4",
      "FamilyName": "sample string 5",
      "ReferralSource": "sample string 6",
      "Notes": "sample string 7",
      "UniqueIdentifier": "sample string 8",
      "Id": "953aa6b2-a211-4481-b7cf-44b364d500c4",
      "CustomerTypeId": 10,
      "CustomerType": "sample string 11",
      "DateOfBirth": "2024-11-07T08:34:27.8641623+00:00",
      "PricingGroupId": 13,
      "Disabled": true,
      "DoNotContact": true,
      "Version": 16,
      "MergedIntoCustomerId": {},
      "LastModifiedDateUtc": "2024-11-07T08:34:27.8641623+00:00"
    }
  ]
}