Submit Feedback

curl -X POST https://api.parsetx.dev/v1/feedback \
  -H "X-API-Key: ptx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "raw_input": "AMZN MKTP US*1A2B3C",
    "returned_name": "Amazon Fresh",
    "returned_category": "Grocery",
    "correct_name": "Amazon Marketplace",
    "correct_category": "Shopping",
    "notes": "This was a standard marketplace purchase, not Amazon Fresh."
  }'

import requests

response = requests.post(
    "https://api.parsetx.dev/v1/feedback",
    headers={"X-API-Key": "ptx_live_..."},
    json={
        "raw_input": "AMZN MKTP US*1A2B3C",
        "returned_name": "Amazon Fresh",
        "correct_name": "Amazon Marketplace",
        "correct_category": "Shopping",
    }
)
print(response.json())

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Thank you for your feedback. We review all submissions."
}

{
  "error": "Validation failed",
  "details": {
    "raw_input": ["String must contain at least 1 character(s)"]
  }
}

POST

feedback

curl -X POST https://api.parsetx.dev/v1/feedback \
  -H "X-API-Key: ptx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "raw_input": "AMZN MKTP US*1A2B3C",
    "returned_name": "Amazon Fresh",
    "returned_category": "Grocery",
    "correct_name": "Amazon Marketplace",
    "correct_category": "Shopping",
    "notes": "This was a standard marketplace purchase, not Amazon Fresh."
  }'

import requests

response = requests.post(
    "https://api.parsetx.dev/v1/feedback",
    headers={"X-API-Key": "ptx_live_..."},
    json={
        "raw_input": "AMZN MKTP US*1A2B3C",
        "returned_name": "Amazon Fresh",
        "correct_name": "Amazon Marketplace",
        "correct_category": "Shopping",
    }
)
print(response.json())

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Thank you for your feedback. We review all submissions."
}

{
  "error": "Validation failed",
  "details": {
    "raw_input": ["String must contain at least 1 character(s)"]
  }
}

Use this endpoint to flag a transaction enrichment that returned wrong data — wrong merchant name, wrong category, or a misidentified merchant entirely. All submissions are reviewed. We update the underlying cache and LLM prompts based on real-world reports.

Request Body

string

required

The raw transaction string you passed to /v1/enrich.

string

The merchant name ParseTx returned (for context — helps us locate the cached entry).

string

The category ParseTx returned.

string

What the merchant name should be.

string

What the category should be.

string

Any additional context. Max 1,000 characters.

Response

Returns 201 Created on success.

string

UUID of the feedback record.

string

Confirmation message.

curl -X POST https://api.parsetx.dev/v1/feedback \
  -H "X-API-Key: ptx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "raw_input": "AMZN MKTP US*1A2B3C",
    "returned_name": "Amazon Fresh",
    "returned_category": "Grocery",
    "correct_name": "Amazon Marketplace",
    "correct_category": "Shopping",
    "notes": "This was a standard marketplace purchase, not Amazon Fresh."
  }'

import requests

response = requests.post(
    "https://api.parsetx.dev/v1/feedback",
    headers={"X-API-Key": "ptx_live_..."},
    json={
        "raw_input": "AMZN MKTP US*1A2B3C",
        "returned_name": "Amazon Fresh",
        "correct_name": "Amazon Marketplace",
        "correct_category": "Shopping",
    }
)
print(response.json())

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Thank you for your feedback. We review all submissions."
}

{
  "error": "Validation failed",
  "details": {
    "raw_input": ["String must contain at least 1 character(s)"]
  }
}

Getting Started

API Reference

Guides

SDKs

Changelog

Submit Feedback

Request Body

Response

​Request Body

​Response

Request Body

Response