action plaid_categories_get {
  label: "Get Categories"
  description: "Send a request to the `/categories/get` endpoint to get detailed information on categories returned by Plaid. This endpoint does not require authentication."
  provider: plaid
  method: POST
  path: "/categories/get"
  encoding: json
  input: {
    type: "object"
    description: "CategoriesGetRequest defines the request schema for `/categories/get`"
  }
  output: {
    type: "object"
    description: "CategoriesGetResponse defines the response schema for `/categories/get`"
    required: ["categories", "request_id"]
    properties: {
      categories: {
        type: "array"
        description: "An array of all of the transaction categories used by Plaid."
        items: {
          type: "object"
          description: "Information describing a transaction category"
          required: ["category_id", "group", "hierarchy"]
          properties: {
            category_id: {
              type: "string"
              description: "An identifying number for the category. `category_id` is a Plaid-specific identifier and does not necessarily correspond to merchant category codes."
            }
            group: {
              type: "string"
              description: "`place` for physical transactions or `special` for other transactions such as bank charges."
            }
            hierarchy: {
              type: "array"
              description: "A hierarchical array of the categories to which this `category_id` belongs."
              items: {
                type: "string"
              }
            }
          }
        }
      }
      request_id: {
        type: "string"
        description: "A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive."
      }
    }
  }
}