Record a checkout survey answer

The tracker transport for a post-checkout self-reported source answer.

POST/api/v1/poll

Access: Public · no authentication · Permission details

JSON request body

JSON request fields
Field	Type	Description
`siteId`Required	`string`	Website ID.
`source`Required	`string`	Survey answer, stored up to 120 characters.
`visitorId`	`string`	Visitor whose latest transaction receives the answer; required unless txId is supplied.
`txId`	`string`	External transaction ID; used instead of visitorId when supplied.

Request examples

Examples run from your server or terminal. Configure ATTRIBOO_TOKEN privately for authenticated requests. Replace example website IDs and values with your own. The examples make real requests when you run them.

cURL request

curl -X POST "https://www.attriboo.com/api/v1/poll" \
  -H "Content-Type: application/json" \
  --data '{
  "siteId": "site_example",
  "visitorId": "v_example",
  "source": "A colleague"
}'

Response

Illustrative response. This endpoint returns raw JSON. Optional coverage, notes and continuation fields vary by report.

Response fields
Field	Type	Description
`ok`	`boolean`	Whether the request succeeded.
`matched`	`boolean`	Whether a transaction was found.

JSON response

{
  "ok": true,
  "matched": true
}

Behavior and limits

Prefer the built-in post-checkout survey. Supply visitorId or txId. The answer is attached to the latest matching website transaction.

matched: false means no transaction was found; it does not create a sale. Self-reported source is separate from observed attribution credit.

HTTP status	Meaning
400	Missing fields or answer could not be recorded.

Errors and retries OpenAPI JSON