Public REST/JSON reference

Return Fraud Pattern Detector API

Score return requests and customer histories for serial returns, wardrobing, bracketing, and claim-without-ship patterns, then route risky returns to verification, manual review, or enforcement. Part of the Logic Igniter E-commerce Operations bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/returnfraud.json

Operations rendered

Response models rendered

GET/api/v1/returnfraud/health

Service liveness

Liveness probe for Return Fraud Pattern Detector API. Returns 200 when the public API route is reachable.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/health" \
  -H "Accept: application/json"

Responses

200

Service healthy

GET/api/v1/returnfraud/customers

List customers

List customers record for the customer workspace used by Return Fraud Pattern Detector API.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CustomerList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

PUT/api/v1/returnfraud/customers/{id}

Update customer

Update customer record for the customer workspace used by Return Fraud Pattern Detector API.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string	Id

Request body (required)

Schema: CustomerInput

Sample JSON payload for evaluation.

{
  "companyName": "Mira Home Goods",
  "email": "[email protected]"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/returnfraud/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"companyName":"Mira Home Goods","email":"[email protected]"}'

Responses

200Customer

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

GET/api/v1/returnfraud/customers/{customer_id}/risk-profile

Get customer risk profile

Read return-risk score, contributing signals, and active flags for a customer.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`customer_id`required	path	string	Customer Id

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/customers/:customer_id/risk-profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200RiskProfile

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

POST/api/v1/returnfraud/customers/{customer_id}/score

Score customer

Score a customer or return request against fraud patterns.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`customer_id`required	path	string	Customer Id

Request body (required)

Schema: FraudScoreRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "FraudScoreRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/returnfraud/customers/:customer_id/score" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"FraudScoreRequest"}'

Responses

200FraudScore

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

GET/api/v1/returnfraud/customers/{customer_id}/patterns

Detect patterns

Return detected return-fraud patterns for a customer.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`customer_id`required	path	string	Customer Id

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/customers/:customer_id/patterns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200FraudPatternList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

POST/api/v1/returnfraud/customers/{customer_id}/override

Override score

Apply a manual override with a reason and expiration.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`customer_id`required	path	string	Customer Id

Request body (required)

Schema: ScoreOverrideRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "ScoreOverrideRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/returnfraud/customers/:customer_id/override" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"ScoreOverrideRequest"}'

Responses

200ScoreOverride

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

GET/api/v1/returnfraud/customers/flagged

List flagged customers

List customers currently above return-risk thresholds.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/customers/flagged" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200FlaggedCustomerList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/returnfraud/returns/sync

Sync returns

Import return requests, dispositions, refunds, and shipment events.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: ReturnSyncRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "ReturnSyncRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/returnfraud/returns/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"ReturnSyncRequest"}'

Responses

200ReturnSyncResult

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

GET/api/v1/returnfraud/returns/stats

Get return stats

Return fraud rate, repeat-return rate, and return cost metrics.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/returns/stats" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200ReturnStats

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

GET/api/v1/returnfraud/enforcement

List enforcement actions

List active and historical enforcement actions.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/returnfraud/enforcement" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200EnforcementActionList

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

POST/api/v1/returnfraud/enforcement/{action_id}/revoke

Revoke enforcement

Revoke an enforcement action and record the reason.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`action_id`required	path	string	Action Id

Request body (required)

Schema: RevokeEnforcementRequest

Sample JSON payload for evaluation.

{
  "id": "obj_123",
  "status": "READY",
  "summary": "RevokeEnforcementRequest"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/returnfraud/enforcement/:action_id/revoke" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"id":"obj_123","status":"READY","summary":"RevokeEnforcementRequest"}'

Responses

200EnforcementAction

Successful response

400Error

Invalid request payload or parameters

401Error

Missing or invalid bearer token

403Error

Workspace does not have access to the ecommerce-operations bundle

404Error

Requested resource was not found

Data models

Customer

Field	Type	Notes
`id`required	string	Example: "cus_mira_home"
`companyName`required	string	Example: "Mira Home Goods"
`email`required	string (email)	Example: "[email protected]"
`bundle`required	string	Example: "ecommerce-operations"
`createdAt`	string (date-time)

CustomerInput

Field	Type	Notes
`companyName`required	string	Example: "Mira Home Goods"
`email`required	string (email)	Example: "[email protected]"
`bundle`	string	Example: "ecommerce-operations"

CustomerList

Field	Type	Notes
`customers`	array<Customer>

Error

Field	Type	Notes
`error`required	string	Example: "validation failed"
`message`	string	Example: "sku is required"
`requestId`	string	Example: "req_01HX9E2M7K8Q4J3V"

EnforcementAction

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "EnforcementAction"

EnforcementActionList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "EnforcementActionList"

EnforcementRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "EnforcementRequest"

FlaggedCustomerList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "FlaggedCustomerList"

FraudPatternList

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "FraudPatternList"

FraudScore

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "FraudScore"

FraudScoreRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "FraudScoreRequest"

ReturnStats

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ReturnStats"

ReturnSyncRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ReturnSyncRequest"

ReturnSyncResult

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ReturnSyncResult"

RevokeEnforcementRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "RevokeEnforcementRequest"

RiskProfile

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "RiskProfile"

ScoreOverride

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ScoreOverride"

ScoreOverrideRequest

Field	Type	Notes
`id`required	string	Example: "obj_123"
`status`required	string	Example: "READY"
`summary`	string	Example: "ScoreOverrideRequest"