API reference / Operations by tag

fraud

Fraud queue, cases, packs, lists, vendor configuration and clawbacks.

30 operations. Base URL https://api.metrixed.com/v1; see authentication, errors and pagination.

Operations

Method	Path	Summary
GET	`/fraud/cases`	Fraud cases (batch findings + manual)
POST	`/fraud/cases`	Open a manual case
GET	`/fraud/cases/{id}`	Case
PATCH	`/fraud/cases/{id}`	Update case status/assignee/resolution
GET	`/fraud/clawbacks`	Clawbacks
POST	`/fraud/clawbacks`	Reject previously approved conversions (ledger reversal via status change)
GET	`/fraud/lists`	Allow/deny list entries
POST	`/fraud/lists`	Add a list entry or bulk {entries:[...]}
PATCH	`/fraud/lists/{id}`	Update list entry
DELETE	`/fraud/lists/{id}`	Remove list entry
GET	`/fraud/partners/{id}/risk`	Partner risk detail
POST	`/fraud/partners/{id}/unblock`	Lift a risk block
GET	`/fraud/partners/risk`	Partner risk roll-up (all partners)
POST	`/fraud/partners/risk/run`	Run the fraud batch (CTIT, Benford, clusters, partner risk) for this tenant now instead of nightly; workers pick it up within ~20 s
GET	`/fraud/partners/risk/status`	Fraud batch run-now status and last result
GET	`/fraud/queue`	Flagged queue (open by default; state=all\|resolved; filter[band\|status\|partner_id\|offer_id])
GET	`/fraud/queue/{id}`	Queue item with explain
POST	`/fraud/queue/bulk`	Bulk approve/reject/scrub/release; status restated through ingest, approved→rejected records a clawback
GET	`/fraud/queue/stats`	Queue counts by band (30 days)
POST	`/fraud/report/install`	Install the shared 'Fraud overview' saved report (idempotent)
GET	`/fraud/rule-packs`	Rule packs
POST	`/fraud/rule-packs`	Create rule pack (tenant/offer/partner scope)
GET	`/fraud/rule-packs/{id}`	Rule pack
PATCH	`/fraud/rule-packs/{id}`	Update rule pack
DELETE	`/fraud/rule-packs/{id}`	Delete rule pack
GET	`/fraud/rule-packs/presets`	Strict/balanced/lenient presets and the signal catalog
POST	`/fraud/score`	Score a sample click/conversion with a pack (simulator)
GET	`/fraud/vendors`	Vendor adapters (IPQS, Anura, 24metrics, Forensiq) — keys masked
PUT	`/fraud/vendors/{vendor}`	Configure a vendor (API key sealed at rest)
POST	`/fraud/vendors/{vendor}/test`	Test a vendor with a sample IP

`GET /fraud/cases`

Fraud cases (batch findings + manual)

Operation getFraudCases. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`page`	query	integer	no
`page_size`	query	integer	no
`sort`	query	string	no	field or -field
`include`	query	string	no	comma-separated relationships
`filter`	query	object (free-form)	no
`q`	query	string	no	free-text search

Status	Description	Body
200	ok	application/json FraudCaseList
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/cases?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "page": {}
}

`POST /fraud/cases`

Open a manual case

Operation postFraudCases. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudCaseCreate

Field	Type	Flags
`kind`	enum: `ctit_distribution`, `benford_subid`, `device_cluster`, `ip_cluster`, `partner_risk`, `manual`, `vendor`
`status`	enum: `open`, `investigating`, `resolved`, `dismissed`
`severity`	enum: `low`, `medium`, `high`, `critical`
`score`	integer
`partner_id`	string
`offer_id`	string
`title`	string	required
`summary`	string
`evidence`	object (free-form)
`period_from`	string (date-time)
`period_to`	string (date-time)
`assigned_to`	string
`resolution_note`	string

Status	Description	Body
201	ok	application/json FraudCase
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/cases' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"title":""}'

Example 201 response:

json

{
  "external_ref": ""
}

`GET /fraud/cases/{id}`

Case

Operation getFraudCasesId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
200	ok	application/json FraudCase
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/cases/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "external_ref": ""
}

`PATCH /fraud/cases/{id}`

Update case status/assignee/resolution

Operation patchFraudCasesId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Request body (application/json, required): FraudCaseUpdate

Field	Type	Flags	Description
`kind`	enum: `ctit_distribution`, `benford_subid`, `device_cluster`, `ip_cluster`, `partner_risk`, `manual`, `vendor`
`status`	enum: `open`, `investigating`, `resolved`, `dismissed`
`severity`	enum: `low`, `medium`, `high`, `critical`
`score`	integer
`partner_id`	string
`offer_id`	string
`title`	string
`summary`	string
`evidence`	object (free-form)
`period_from`	string (date-time)
`period_to`	string (date-time)
`assigned_to`	string
`resolution_note`	string

Status	Description	Body
200	ok	application/json FraudCase
default	error	application/json Error

bash

curl -X PATCH 'https://api.metrixed.com/v1/fraud/cases/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"kind":"ctit_distribution","status":"open","severity":"low","score":0}'

Example 200 response:

json

{
  "external_ref": ""
}

`GET /fraud/clawbacks`

Clawbacks

Operation getFraudClawbacks. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`page`	query	integer	no
`page_size`	query	integer	no
`sort`	query	string	no	field or -field
`include`	query	string	no	comma-separated relationships
`filter`	query	object (free-form)	no
`q`	query	string	no	free-text search

Status	Description	Body
200	ok	application/json LogSearchResult
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/clawbacks?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "rows": [
    {}
  ],
  "next_cursor": "",
  "has_more": false
}

`POST /fraud/clawbacks`

Reject previously approved conversions (ledger reversal via status change)

Operation postFraudClawbacks. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudClawbackRequest

Field	Type	Flags	Description
`conversion_ids`	array of string	required
`reason`	string

Status	Description	Body
200	ok	application/json FraudBulkResult
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/clawbacks' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"conversion_ids":[""]}'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "succeeded": 0,
  "failed": 0
}

`GET /fraud/lists`

Allow/deny list entries

Operation getFraudLists. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`page`	query	integer	no
`page_size`	query	integer	no
`sort`	query	string	no	field or -field
`include`	query	string	no	comma-separated relationships
`filter`	query	object (free-form)	no
`q`	query	string	no	free-text search

Status	Description	Body
200	ok	application/json FraudListEntryList
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/lists?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "page": {}
}

`POST /fraud/lists`

Add a list entry or bulk {entries:[...]}

Operation postFraudLists. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudListEntryCreate

Field	Type	Flags
`kind`	enum: `allow`, `deny`	required
`type`	enum: `ip`, `ip_cidr`, `device`, `email_hash`, `user_id`, `sub_id`, `asn`, `isp`, `referrer_domain`	required
`value`	string	required
`reason`	string
`source`	enum: `manual`, `batch`, `vendor`, `import`
`partner_id`	string
`expires_at`	string (date-time)
`entries`	array of object (free-form)

Status	Description	Body
201	ok	application/json FraudListEntry
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/lists' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"kind":"allow","type":"ip","value":""}'

Example 201 response:

json

{
  "external_ref": ""
}

`PATCH /fraud/lists/{id}`

Update list entry

Operation patchFraudListsId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Request body (application/json, required): FraudListEntryUpdate

Field	Type	Flags	Description
`kind`	enum: `allow`, `deny`
`type`	enum: `ip`, `ip_cidr`, `device`, `email_hash`, `user_id`, `sub_id`, `asn`, `isp`, `referrer_domain`
`value`	string
`reason`	string
`source`	enum: `manual`, `batch`, `vendor`, `import`
`partner_id`	string
`expires_at`	string (date-time)
`entries`	array of object (free-form)

Status	Description	Body
200	ok	application/json FraudListEntry
default	error	application/json Error

bash

curl -X PATCH 'https://api.metrixed.com/v1/fraud/lists/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"kind":"allow","type":"ip","value":"","reason":""}'

Example 200 response:

json

{
  "external_ref": ""
}

`DELETE /fraud/lists/{id}`

Remove list entry

Operation deleteFraudListsId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
204	ok	application/json Ok
default	error	application/json Error

bash

curl -X DELETE 'https://api.metrixed.com/v1/fraud/lists/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 204 response:

json

{
  "ok": false
}

`GET /fraud/partners/{id}/risk`

Partner risk detail

Operation getFraudPartnersIdRisk. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
200	ok	application/json FraudPartnerRisk
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/partners/<id>/risk' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "partner_id": "",
  "score": 0,
  "grade": "A",
  "blocked": false
}

`POST /fraud/partners/{id}/unblock`

Lift a risk block

Operation postFraudPartnersIdUnblock. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
200	ok	application/json FraudPartnerRisk
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/partners/<id>/unblock' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "partner_id": "",
  "score": 0,
  "grade": "A",
  "blocked": false
}

`GET /fraud/partners/risk`

Partner risk roll-up (all partners) Partner risk roll-up (all partners). WP-71: paged with page/page_size (page.total over the whole match); unpaged returns the previous bound with total and capped/cap.

Operation getFraudPartnersRisk. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required
`q`	query	string	no
`page`	query	string	no
`page_size`	query	string	no

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/partners/risk?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}

`POST /fraud/partners/risk/run`

Run the fraud batch (CTIT, Benford, clusters, partner risk) for this tenant now instead of nightly; workers pick it up within ~20 s

Operation postFraudPartnersRiskRun. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json FraudRunStatus
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/partners/risk/run' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{}

`GET /fraud/partners/risk/status`

Fraud batch run-now status and last result

Operation getFraudPartnersRiskStatus. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json FraudRunStatus
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/partners/risk/status' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{}

`GET /fraud/queue`

Flagged queue (open by default; state=all|resolved; filter[band|status|partner_id|offer_id])

Operation getFraudQueue. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`page`	query	integer	no
`page_size`	query	integer	no
`sort`	query	string	no	field or -field
`include`	query	string	no	comma-separated relationships
`filter`	query	object (free-form)	no
`q`	query	string	no	free-text search
`state`	query	enum: `open`, `resolved`, `all`	no

Status	Description	Body
200	ok	application/json FraudQueueItemList
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/queue?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "page": {}
}

`GET /fraud/queue/{id}`

Queue item with explain

Operation getFraudQueueId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
200	ok	application/json FraudQueueItem
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/queue/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "external_ref": ""
}

`POST /fraud/queue/bulk`

Bulk approve/reject/scrub/release; status restated through ingest, approved→rejected records a clawback

Operation postFraudQueueBulk. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudBulkAction

Field	Type	Flags
`action`	enum: `approve`, `reject`, `scrub`, `release`	required
`ids`	array of string	required
`note`	string

Status	Description	Body
200	ok	application/json FraudBulkResult
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/queue/bulk' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"action":"approve","ids":[""]}'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "succeeded": 0,
  "failed": 0
}

`GET /fraud/queue/stats`

Queue counts by band (30 days)

Operation getFraudQueueStats. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/queue/stats' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}

`POST /fraud/report/install`

Install the shared 'Fraud overview' saved report (idempotent)

Operation postFraudReportInstall. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/report/install' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}

`GET /fraud/rule-packs`

Rule packs

Operation getFraudRulePacks. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`page`	query	integer	no
`page_size`	query	integer	no
`sort`	query	string	no	field or -field
`include`	query	string	no	comma-separated relationships
`filter`	query	object (free-form)	no
`q`	query	string	no	free-text search

Status	Description	Body
200	ok	application/json FraudRulePackList
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/rule-packs?page=1&page_size=50' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "data": [
    {}
  ],
  "page": {}
}

`POST /fraud/rule-packs`

Create rule pack (tenant/offer/partner scope)

Operation postFraudRulePacks. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudRulePackCreate

Field	Type	Flags	Description
`name`	string	required
`mode`	enum: `strict`, `balanced`, `lenient`, `custom`
`scope_type`	enum: `tenant`, `offer`, `partner`
`scope_id`	string
`status`	enum: `active`, `paused`, `archived`
`dry_run`	boolean
`priority`	integer
`signal_weights`	object (free-form)		signal code -> weight 0-100 (overrides the mode defaults; see /fraud/rule-packs/presets)
`disabled_signals`	array of string
`click_bands`	array of object (free-form)
`conversion_bands`	array of object (free-form)
`block_partner_score`	integer
`params`	object (free-form)		ctit_min_seconds, flood_window_seconds, flood_max_ip, flood_max_sub, flood_max_partner, device_repeat_max, velocity_window_seconds, velocity_max_partner, duplicate_ip_max, cr_baseline_pct, cr_anomaly_factor, cr_min_clicks, night_start_hour, night_end_hour, uniform_ctit_tolerance, min_uniform_sample, allowed_geos[], min_sdk_version

Status	Description	Body
201	ok	application/json FraudRulePack
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/rule-packs' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":""}'

Example 201 response:

json

{
  "external_ref": ""
}

`GET /fraud/rule-packs/{id}`

Rule pack

Operation getFraudRulePacksId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
200	ok	application/json FraudRulePack
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/rule-packs/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "external_ref": ""
}

`PATCH /fraud/rule-packs/{id}`

Update rule pack

Operation patchFraudRulePacksId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Request body (application/json, required): FraudRulePackUpdate

Field	Type	Description
`name`	string
`mode`	enum: `strict`, `balanced`, `lenient`, `custom`
`scope_type`	enum: `tenant`, `offer`, `partner`
`scope_id`	string
`status`	enum: `active`, `paused`, `archived`
`dry_run`	boolean
`priority`	integer
`signal_weights`	object (free-form)	signal code -> weight 0-100 (overrides the mode defaults; see /fraud/rule-packs/presets)
`disabled_signals`	array of string
`click_bands`	array of object (free-form)
`conversion_bands`	array of object (free-form)
`block_partner_score`	integer
`params`	object (free-form)	ctit_min_seconds, flood_window_seconds, flood_max_ip, flood_max_sub, flood_max_partner, device_repeat_max, velocity_window_seconds, velocity_max_partner, duplicate_ip_max, cr_baseline_pct, cr_anomaly_factor, cr_min_clicks, night_start_hour, night_end_hour, uniform_ctit_tolerance, min_uniform_sample, allowed_geos[], min_sdk_version

Status	Description	Body
200	ok	application/json FraudRulePack
default	error	application/json Error

bash

curl -X PATCH 'https://api.metrixed.com/v1/fraud/rule-packs/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"","mode":"strict","scope_type":"tenant","scope_id":""}'

Example 200 response:

json

{
  "external_ref": ""
}

`DELETE /fraud/rule-packs/{id}`

Delete rule pack

Operation deleteFraudRulePacksId. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`id`	path	string	yes

Status	Description	Body
204	ok	application/json Ok
default	error	application/json Error

bash

curl -X DELETE 'https://api.metrixed.com/v1/fraud/rule-packs/<id>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 204 response:

json

{
  "ok": false
}

`GET /fraud/rule-packs/presets`

Strict/balanced/lenient presets and the signal catalog

Operation getFraudRulePacksPresets. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/rule-packs/presets' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}

`POST /fraud/score`

Score a sample click/conversion with a pack (simulator)

Operation postFraudScore. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): FraudScoreRequest

Field	Type	Flags	Description
`kind`	enum: `click`, `conversion`	required
`pack_id`	string
`mode`	enum: `strict`, `balanced`, `lenient`
`input`	object (free-form)	required	ClickInput / ConversionInput fields (IP, UA, Country, ClickTS, ...)

Status	Description	Body
200	ok	application/json FraudResult
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/score' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"kind":"click","input":{}}'

Example 200 response:

json

{
  "score": 0,
  "band": "",
  "action": "",
  "reasons": [
    ""
  ]
}

`GET /fraud/vendors`

Vendor adapters (IPQS, Anura, 24metrics, Forensiq) — keys masked

Operation getFraudVendors. Auth: API key (Bearer) or session cookie.

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl 'https://api.metrixed.com/v1/fraud/vendors' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}

`PUT /fraud/vendors/{vendor}`

Configure a vendor (API key sealed at rest)

Operation putFraudVendorsVendor. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`vendor`	path	string	yes

Request body (application/json, required): FraudVendorConfig

Field	Type	Flags	Description
`vendor`	enum: `ipqs`, `anura`, `24metrics`, `forensiq`, `fake`
`enabled`	boolean
`api_key`	string		sealed at rest; never returned
`has_api_key`	boolean	read-only
`settings`	object (free-form)		base_url, timeout_ms, extra{instance,...}, block_at, flag_at, mode click\|conversion\|both
`last_error`	string	read-only
`last_used_at`	string (date-time)	read-only

Status	Description	Body
200	ok	application/json FraudVendorConfig
default	error	application/json Error

bash

curl -X PUT 'https://api.metrixed.com/v1/fraud/vendors/<vendor>' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"vendor":"ipqs","enabled":false,"api_key":""}'

Example 200 response:

json

{
  "vendor": "ipqs",
  "enabled": false,
  "api_key": ""
}

`POST /fraud/vendors/{vendor}/test`

Test a vendor with a sample IP

Operation postFraudVendorsVendorTest. Auth: API key (Bearer) or session cookie.

Parameter	In	Type	Required	Description
`vendor`	path	string	yes

Status	Description	Body
200	ok	application/json Ok
default	error	application/json Error

bash

curl -X POST 'https://api.metrixed.com/v1/fraud/vendors/<vendor>/test' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json

{
  "ok": false
}