Policy

One case with its timeline

Returns one case: rule, advertiser, affiliate ID, status, owner, first and last seen, match and reopen counts, and the timeline of every status change, owner change and note, oldest first. The case records that saved ads matched an internal rule; it is not a confirmed policy finding. Use list_policy_case_evidence to review the matching ads. A match is a lead to review: an observation shows an ad was displayed for a search at a moment, not proof of a violation, spend or a purchased keyword.

get/projects/{project_id}/policy-cases/{case_id}

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/policy-cases/{case_id}
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

case_idstring required

The case id from list_policy_cases.

Response

One case with its timeline

idstring required
rule_idstring nullable required

null when the rule was deleted; rule_name is kept.

rule_namestring required
rule_type'forbidden_terms' | 'brand_term' | 'direct_linking' | 'promo_code' | 'position_limit' | 'affiliate_id' required
advertiser_domainstring required
affiliate_idstring nullable required
status'open' | 'investigating' | 'contacted' | 'resolved' | 'dismissed' required
owner_user_idstring nullable required
owner_emailstring nullable required
first_seen_atstring required
last_seen_atstring required
match_countinteger required

Every finding recorded on the case.

reopen_countinteger required

Times a new match reopened it after it was resolved.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.