Export customer merges

This export doesn't use the submit-and-poll pattern. It's a synchronous, paginated request.

Method

Send a POST request. Configure the operation in Maestra first; use its name in the {operation name} parameter. For more on calling operations, see Operations API.

POST https://api.maestra.io/v3/operations/sync?endpointId={endpointId}&operation={operation name}

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Secret key — ask your Maestra marketer if it's required}

<operation>
  <customerMergesPage>
    <pageNumber>{Page number, starting at 1 — max 2147484}</pageNumber>
    <itemsPerPage>{Items per page — max 10000}</itemsPerPage>
    <sinceDateTimeUtc>{Start of the change window, inclusive}</sinceDateTimeUtc>
    <tillDateTimeUtc>{End of the change window, exclusive — must be at least five minutes before the current time}</tillDateTimeUtc>
  </customerMergesPage>
  <executionDateTimeUtc>{Execution datetime — for backdated requests}</executionDateTimeUtc>
</operation>
  • Returns every customer merged between sinceDateTimeUtc and tillDateTimeUtc.
  • Pages are numbered starting at 1.
  • Maximum 10,000 customers per page.

Example

POST https://api.maestra.io/v3/operations/sync?endpointId=MaestraDemo&operation=MergedCustomers

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p664m85bklq

<operation>
  <customerMergesPage>
    <pageNumber>1</pageNumber>
    <itemsPerPage>500</itemsPerPage>
    <sinceDateTimeUtc>2018-09-16 16:46:58.639</sinceDateTimeUtc>
    <tillDateTimeUtc>2018-09-18 16:46:58.639</tillDateTimeUtc>
  </customerMergesPage>
  <executionDateTimeUtc>2018-10-17 16:46:58.639</executionDateTimeUtc>
</operation>

Returns the first 500 customers merged between September 16 and September 18, 2018.

Response

Content-Type: application/xml; charset=utf-8

<result>
  <status>Success</status>
  <customerMerges>
    <customerMerge>
      <resultingCustomer>
        <ids>
          <mindboxId>1810454157</mindboxId>
          <tehID>338838091</tehID>
          <userwebsiteid>76026058</userwebsiteid>
          <vkID>qoaPV</vkID>
        </ids>
        <changeDateTimeUtc>2018-09-18 20:46:58.670</changeDateTimeUtc>
      </resultingCustomer>
      <mergedCustomers>
        <mergedCustomer>
          <ids>
            <mindboxId>1289531450</mindboxId>
            <tehID>773732863</tehID>
            <userwebsiteid>1820856461</userwebsiteid>
            <vkID>sZHHbaQj</vkID>
          </ids>
        </mergedCustomer>
        <mergedCustomer>
          <ids>
            <mindboxId>1795392557</mindboxId>
            <tehID>338838091</tehID>
            <userwebsiteid>1575884755</userwebsiteid>
            <vkID>qoaPV</vkID>
          </ids>
        </mergedCustomer>
      </mergedCustomers>
    </customerMerge>
    <customerMerge>
      <resultingCustomer>
        <ids>
          <mindboxId>1811914583</mindboxId>
          <tehID>634419423</tehID>
          <userwebsiteid>1205088101</userwebsiteid>
          <vkID>PosalSc5I</vkID>
        </ids>
        <changeDateTimeUtc>2018-09-17 18:46:58.670</changeDateTimeUtc>
      </resultingCustomer>
      <mergedCustomers>
        <mergedCustomer>
          <ids>
            <mindboxId>285524710</mindboxId>
            <tehID>1121596055</tehID>
            <userwebsiteid>485794984</userwebsiteid>
            <vkID>PosalSc5I</vkID>
          </ids>
        </mergedCustomer>
        <mergedCustomer>
          <ids>
            <mindboxId>40879857</mindboxId>
            <tehID>792267062</tehID>
            <userwebsiteid>664153368</userwebsiteid>
            <vkID>yU9uER8</vkID>
          </ids>
        </mergedCustomer>
      </mergedCustomers>
    </customerMerge>
  </customerMerges>
</result>