PluggyDocs
GET/categories

List

Recovers all categories active from the data categorization. Can be filtered by the parentId of the category.

Parameters

Query Parameters

NameType
parentId
string

Responses

200Retrieve a list of all categories
object

Paginated list of transaction categories

resultsrequiredobject[]

Categories for the current page

itemsobject

Cateogry response

pagerequirednumber (double)
totalrequirednumber (double)
totalPagesrequirednumber (double)

Example response

json
{
  "page": 1,
  "total": 2,
  "totalPages": 1,
  "results": [
    {
      "id": "01000000",
      "description": "Income",
      "descriptionTranslated": "Renda"
    },
    {
      "id": "01010000",
      "description": "Salary/pro-labore",
      "descriptionTranslated": "Salário",
      "parentId": "01000000",
      "parentDescription": "Income"
    }
  ]
}

Code Examples

bash
curl -X GET 'https://api.pluggy.ai/categories' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'

Try It

Query Parameters