---
title: "Categorize"
method: POST
path: "/categorize"
---

# Categorize

`POST /categorize`

## Request body

- object
  - `clientUserId` string — _identifier for the user (ie. email or cpf)_
  - `isBusiness` boolean — If the holder is a Business, if not is a Person.
  - `accountType` 'CHECKING' | 'CREDIT_CARD' — Type of the account holder of the transactions
  - `transactions` object[] — Transactions to enrich, max 5000
    - `id` string — Unique identifier of the transaction
    - `description` string — The description of the transaction to categorize
    - `type` 'CREDIT' | 'DEBIT' — Direction of the transaction. If not sent will use the amount to set it.
    - `amount` number, float — Amount of the transaction, negative represents a debit and a positive a credit.
    - `date` string — Date in ISO format of the transaction's date
    - `paymentData` object — Payment information related to the parties involved
      - `paymentMethod` string — Method of the payment (PIX, BOLETO, TED, DOC)
      - `reason` string — Description sent by the payer
      - `payer` object — Sender information of the transaction
        - `name` string — Name of the Participant
        - `accountNumber` string — Account number
        - `branchNumber` string — Agency Number
        - `routingNumber` string — Bank number (Compe code)
        - `documentNumber` object
      - `receiver` object — Receiver of the transaction
    - `creditCardMetadata` object — Credit card metadata for the transaction.
      - `payeeMCC` string — MCC Code for the credit card transaction

## Response `200`

200

- object
  - `results` object[]
    - `id` string
    - `date` string
    - `description` string
    - `type` string
    - `amount` integer
    - `category` string
    - `merchant` object
      - `name` string
      - `businessName` string
      - `cnpj` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.net/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/versions/75e87ec7f9cd/schema)
