Get a customer's full touchpoint journey

GET

https://numueg.app/api/v1/stores/{store_id}/customers/{customer_id}/journey

Last modified:2026-09-19 16:39:33

x-numu-scope:customers:read

Return every UTM-tagged inbound visit this customer made.

Sourced from customer_touches — populated incrementally by the
/track endpoint for known customers, and backfilled at checkout
for anonymous sessions that converted (linking the pre-auth
history into the profile).

Order: most recent first. The merchant hub renders this as a
reverse-chrono timeline; is_first_touch is preserved on each
row so the very first touch can be highlighted regardless of
where it falls in the result set.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//customers//journey?limit=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "customer_id": "string",
        "touch_count": 0,
        "touches": [
            {
                "id": "string",
                "ts": "string",
                "utm_source": "string",
                "utm_medium": "string",
                "utm_campaign": "string",
                "utm_term": "string",
                "utm_content": "string",
                "gclid": "string",
                "fbclid": "string",
                "ttclid": "string",
                "referrer": "string",
                "landing_path": "string",
                "campaign_id": "string",
                "campaign_name": "string",
                "is_first_touch": true
            }
        ]
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Erase a customer's analytics footprint (DSAR)

Conversations linked to this customer