Trace how a synthetic click would be resolved by this link's smart redirect rules, without writing any click/analytics data or touching sticky bindings, rotation counters, or offer caps.

POST

/api/v1/links/{code}/simulate

curl --request POST \
  --url https://example.com/api/v1/links/example/simulate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "countryCode": "US", "city": "New York", "deviceType": "desktop", "os": "Windows", "browser": "Chrome", "language": "en-US", "referer": "https://google.com/search", "ip": "203.0.113.10", "isBot": false, "subIds": { "sub_id_1": "campaign-42" }, "queryParams": { "utm_source": "newsletter" }, "requestTime": "example" }'

Authorizations

• bearer

Parameters

Path Parameters

code

required

string

Short code or custom alias

Request Body^required

Media typeapplication/json

object

countryCode

string

Example

US

city

string

Example

New York

deviceType

string

Allowed values: desktop mobile tablet

os

string

Example

Windows

browser

string

Example

Chrome

language

string

Example

en-US

referer

string

Example

https://google.com/search

ip

string

Example

203.0.113.10

isBot

boolean

subIds

object

Example

{
  "sub_id_1": "campaign-42"
}

queryParams

object

Example

{
  "utm_source": "newsletter"
}

requestTime

ISO 8601 timestamp — defaults to now. Drives timetable/date_between filters.

string

Responses

200

Rule trace and final decision

403

Forbidden — not the owner

404

Link not found