api-referenceDEL
DELETEhttps://analytics.flowsery.com/api/v1/payments

Delete payment records by transaction ID, visitor, or within a date range.

Bearer Token (API key)

At least one filter required

At least one query parameter must be provided. Calling this endpoint with no filters returns a 400 error.

Query parameters

ParameterTypeDescription
transactionIdstringRemove the payment matching a specific transaction ID.
visitorIdstringRemove all payments tied to a specific visitor ID.
startAtstringISO 8601 start timestamp (e.g., 2024-01-01T00:00:00Z).
endAtstringISO 8601 end timestamp (e.g., 2024-01-31T23:59:59Z).

Deletion behavior

<strong>Transaction ID only:</strong> Removes the specific payment record.

<strong>Visitor ID only:</strong> Removes all payments for that visitor (all time).

<strong>Time range only:</strong> Removes every payment within that period.

<strong>Visitor ID + time range:</strong> Removes payments for the visitor within the window.

<strong>Transaction ID + time range:</strong> Removes the specific transaction if it falls within the range.

Supplying <code>transactionId</code> or <code>visitorId</code> without a time range deletes ALL matching records across the entire history.

Error responses

<strong>400 Bad Request</strong> -- No filter parameters were provided.

<strong>401 Unauthorized</strong> -- API key is missing or invalid.

Delete a specific transaction
curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?transactionId=payment_456" \
  -H "Authorization: Bearer flow_sk_live_abc123"
Delete payments for a visitor in a date range
curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd&startAt=2024-01-01T00:00:00Z&endAt=2024-03-31T23:59:59Z" \
  -H "Authorization: Bearer flow_sk_live_abc123"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 3,
      "message": "Payment records deleted successfully"
    }
  ]
}