---
title: Categorization API
slug: ki/categorization-api
description: Learn how to use Klavi's API to categorize raw transactions from partners with this comprehensive document. Find code examples for making a POST request to the API, along with headers and payload details. Discover how the API response provides categorized
docTags: 
createdAt: 2022-03-28T09:55:07.000Z
---

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api-testing.klavi.ai/klass/transaction/v1/category",
  "name": "/category",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [
      {
        "kind": "required",
        "name": "partner_code",
        "type": "string",
        "description": "Unique private identifier for the partner to access Klavi API services, like user name."
      },
      {
        "kind": "required",
        "name": "partner_token",
        "type": "string",
        "description": "Unique private authentication key for the partner to access Klavi API services, like password."
      }
    ],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "uuid",
        "type": "string",
        "description": "Unique key for a specific bank connection of the certain user"
      },
      {
        "kind": "required",
        "name": "institutionCode",
        "type": "string",
        "description": "bank ID"
      },
      {
        "kind": "required",
        "name": "transactionSource",
        "type": "string",
        "description": "Account type of transaction(“checking”/”credit”)"
      },
      {
        "kind": "required",
        "name": "transactionDetails",
        "type": "Object",
        "description": "Transaction object"
      },
      {
        "kind": "optional",
        "name": "transactionId",
        "type": "string",
        "description": "Transaction ID"
      },
      {
        "kind": "required",
        "name": "transactionDate",
        "type": "string",
        "description": "Transaction date"
      },
      {
        "kind": "required",
        "name": "amount",
        "type": "Number",
        "description": "Transaction amount"
      },
      {
        "kind": "required",
        "name": "transactionName",
        "type": "string",
        "description": "Transaction description"
      },
      {
        "kind": "required",
        "name": "creditDebitType",
        "type": "string",
        "description": "Cashflow, \"credito\"/\"debito\""
      },
      {
        "kind": "optional",
        "name": "transactionType",
        "type": "string",
        "description": "transaction type"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "mdfrVHaMyio_86BJo0AWN",
        "code": "{\n    \"uuid\":\"124eed4\",\n    \"institutionCode\":\"208\",\n    \"transactionSource\":\"checking\",\n    \"categoryDetails\":[\n        {\n            \"transactionId\":\"0013a943abb6b72e6c6e45b8af063aa8e538b1d786fb\",\n            \"transactionDate\":\"2022-02-09\",\n            \"transactionName\":\"Creditamos o empréstimo pessoal do Mercado Crédito\",\n            \"amount\":500,\n            \"creditDebitType\":\"CREDITO\",\n            \"transactionType\":\"OUTROS\",\n            \"category\":\"Empréstimo\"\n        },\n        {\n            \"transactionId\":\"0013a943abb6b72e6c6e45b8af063aa8e538b1d786fc\",\n            \"transactionDate\":\"2022-02-10\",\n            \"transactionName\":\"ALIANCASUPERMERCADO\",\n            \"amount\":500,\n            \"creditDebitType\":\"CREDITO\",\n            \"transactionType\":\"PAGAMENTO\",\n            \"category\":\"Outras transação de crédito\"\n        }\n    ]\n}",
        "language": "200",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "mdfrVHaMyio_86BJo0AWN"
  },
  "examples": {
    "languages": [
      {
        "id": "M3E-OYfvXQY2PSwy1vJex",
        "code": "$ curl -X POST https://api-testing.klavi.ai/klass/transaction/v1/category \\\n-H 'Content-Type: application/json' \\\n-H 'partner_code: 123xxx' \\\n-H 'partner_token: 2fd6cbcddeafd5ToRxbv8Q9UtfDMO' \\\n-d '{\n    \"uuid\":\"124eed4\",\n    \"institutionCode\":\"208\",\n    \"transactionSource\":\"checking\",\n    \"transactionDetails\":[\n        {\n            \"transactionId\":\"0013a943abb6b72e6c6e45b8af063aa8e538b1d786fb\",\n            \"transactionDate\":\"2022-02-09\",\n            \"transactionName\":\"Creditamos o empréstimo pessoal do Mercado Crédito\",\n            \"amount\":500,\n            \"creditDebitType\":\"CREDITO\",\n            \"transactionType\":\"OUTROS\"\n        },\n        {\n            \"transactionId\":\"0013a943abb6b72e6c6e45b8af063aa8e538b1d786fc\",\n            \"transactionDate\":\"2022-02-10\",\n            \"transactionName\":\"ALIANCASUPERMERCADO\",\n            \"amount\":500,\n            \"creditDebitType\":\"CREDITO\",\n            \"transactionType\":\"PAGAMENTO\"\n        }\n    ]\n}'",
        "language": "curl",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "M3E-OYfvXQY2PSwy1vJex"
  },
  "description": "Klavi provides an easy way to categorize any raw transactions from partners, using the following API.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  }
}
```
:::