Skip to main content
POST
/
api
/
transaction-categories
/
{transactionId}
Assign category to transaction
curl --request POST \
  --url https://api.ai2fin.com/api/transaction-categories/{transactionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "categoryId": "<string>",
  "categorySetId": "<string>",
  "isPrimary": false,
  "confidence": 0.5,
  "assignedBy": "user",
  "notes": "<string>"
}
'
{
  "success": true,
  "category": {
    "id": "<string>",
    "transactionId": "<string>",
    "categoryId": "<string>",
    "categorySetId": "<string>",
    "userId": "<string>",
    "isPrimary": true,
    "confidence": 0.5,
    "assignedBy": "user",
    "assignedAt": "2023-11-07T05:31:56Z",
    "notes": "<string>",
    "category": {
      "id": "<string>",
      "name": "<string>",
      "icon": "<string>",
      "color": "<string>",
      "isTaxDeductible": true,
      "taxCategory": "<string>",
      "defaultGstRate": 123
    }
  }
}

Authorizations

Authorization
string
header
required

JWT token obtained from /api/auth/login endpoint. Use for standard API access and OAuth-based integrations.

Path Parameters

transactionId
string
required

Body

application/json
categoryId
string
required
categorySetId
string
isPrimary
boolean
default:false
confidence
number
Required range: 0 <= x <= 1
assignedBy
enum<string>
Available options:
user,
ai,
import,
rule,
bulk
notes
string

Response

200 - application/json

Category assigned

success
boolean
category
object

A category assignment for a transaction. Transactions can have multiple categories from different sets.