Bud Financial Limited Enrichment Resources API

Obtain greater context to Bud's enrichment services.

Operations 3

GET /resources/v2/categories/models Retrieve Available Categorisation Models V2 #
GET /resources/v2/categories Retrieve Categories V2 #
GET /v1/categories Retrieve Categories #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/thisisbud:thisisbud-enrichment-resources-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thisisbud-enrichment-resources-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Thisisbud Enrichment Resources API
  x-logo:
    url: data:image/png;base64,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
  version: '1.0'
  description: 'Operations tagged Enrichment Resources across 2 of this provider''s published API definitions: thisisbud-openapi-openapi.yml, thisisbud-openapi-us-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api-sandbox.thisisbud.com
- url: https://api-sandbox-us.thisisbud.com
tags:
- name: Enrichment Resources
  x-displayName: Enrichment Resources
  description: Obtain greater context to Bud's enrichment services.
paths:
  /resources/v2/categories/models:
    get:
      tags:
      - Enrichment Resources
      summary: Retrieve Available Categorisation Models V2
      description: Retrieve the available Bud categorisation models.
      operationId: resources_v2_models_get
      security:
      - OAuth2: []
      parameters:
      - $ref: '#/components/parameters/ClientId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetModelsResponse'
              example:
                operation_id: resources_v2_models_get
                data:
                - name: uk-v2
                  description: 'A UK categorisation model. This model can be used for the following use cases: affordability assessments, collections assessments, affordability monitoring, customer engagement and product recommendations.'
        '400':
          description: The request contains an invalid payload.
        '401':
          description: Unauthorised request
        '405':
          description: An unexpected HTTP method was used
        5XX:
          description: An unexpected error occurred on the server side
    servers:
    - url: https://api-sandbox.thisisbud.com
  /resources/v2/categories:
    get:
      tags:
      - Enrichment Resources
      summary: Retrieve Categories V2
      description: Retrieve a list of primary and secondary categories supported by Bud's categorisation model.
      operationId: resources_v2_categories_get
      security:
      - OAuth2: []
      parameters:
      - $ref: '#/components/parameters/ClientId'
      - in: query
        name: format
        schema:
          type: string
          enum:
          - map
          - flat
          default: flat
        description: "Determines if the response will be structured:\n  - As a flat object where all categories and subcategories are listed separately under different fields. See the example response `Flat Response`.\n  - As a map where all categories are listed as objects themselves with their respective subcategories listed in fields within the category objects. See the example response `Map Response`.\n"
      - in: query
        name: model
        schema:
          type: string
        description: 'The name of the model for which categories should be returned. See the *List Categorisation Models V2* endpoint for available model names.

          '
      - in: query
        name: label
        schema:
          type: string
        description: Filter out categories that do not have the specified label. If unset, endpoint will include all labels
        example: essential
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCategoriesV2Response'
              examples:
                Category List (flat):
                  value:
                    operation_id: resources_v2_categories_get
                    data:
                      categories:
                      - travel
                      - banking
                      subcategories:
                      - holiday_and_travel_expenses
                      - flights_and_airport_expenses
                      - other_travel
                      - bank_fees_and_currency_exchange
                      - other_banking
                      - cash_withdrawals
                      - refunds_and_reversals
                      - overdraft_fees
                      - unpaid_transactions
                    metadata:
                      model:
                        name: uk-v2
                        description: 'A UK categorisation model. This model can be used for the following use cases: affordability assessments, collections assessments, affordability monitoring, customer engagement and product recommendations.'
                Category Map:
                  value:
                    operation_id: resources_v2_categories_get
                    data:
                    - name: travel
                      subcategories:
                      - name: holiday_and_travel_expenses
                        labels:
                        - travel
                      - name: flights_and_airport_expenses
                      - name: other_travel
                      labels:
                      - nonessential
                    - name: banking
                      subcategories:
                      - name: bank_fees_and_currency_exchange
                        labels:
                        - essential
                      - name: other_banking
                        labels:
                        - nonessential
                      - name: cash_withdrawals
                        labels:
                        - nonessential
                      - name: interest
                        labels:
                        - essential
                      - name: refunds_and_reversals
                      - name: overdraft_fees
                        labels:
                        - essential
                      - name: unpaid_transactions
                        labels:
                        - essential
                    metadata:
                      model:
                        name: uk-v2
                        description: 'A UK categorisation model. This model can be used for the following use cases: affordability assessments, collections assessments, affordability monitoring, customer engagement and product recommendations.'
        '400':
          description: The request contains an invalid payload.
        '401':
          description: Unauthorised request
        '404':
          description: Model not found
        '405':
          description: An unexpected HTTP method was used
        5XX:
          description: An unexpected error occurred on the server side
    servers:
    - url: https://api-sandbox.thisisbud.com
  /v1/categories:
    get:
      tags:
      - Enrichment Resources
      summary: Retrieve Categories
      deprecated: true
      description: Retrieve the category taxonomies related to Bud's categorisation service
      operationId: categories_get
      parameters:
      - $ref: '#/components/parameters/ClientId'
      - in: query
        name: format
        schema:
          type: string
          enum:
          - map
          - flat
        description: "Determines if the response will be structured:\n  - As a flat object where all categories and subcategories are listed separately under different fields. See the example response `Flat Response`.\n  - As a map where all categories are listed as objects themselves with their respective subcategories listed in fields within the category objects. See the example response `Map Response`.\n"
      security:
      - OAuth2: []
      responses:
        '200':
          description: The operation was successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CategoriesResponse'
              examples:
                Flat Response:
                  value:
                    operation_id: categories_double_cat_get
                    data:
                      categories:
                      - dependent_costs
                      - other_expenses
                      - entertainment
                      - transport
                      - banking
                      - eating_out
                      - insurance
                      - borrowing_and_loans
                      - shopping
                      - income
                      - charity
                      - health_and_personal_care
                      - home
                      - groceries
                      - holidays_and_travel
                      - pensions_savings_and_investments
                      - education
                      - transfers
                      - bills
                      - general
                      subcategories:
                      - other_dependent_costs
                      - children_and_babies
                      - childcare
                      - business_expenses
                      - financial_and_legal_expenses
                      - postage_and_office_supplies
                      - other_expenses
                      - amusement
                      - hobbies
                      - books_and_reading
                      - events
                      - gambling
                      - media_subscriptions
                      - cinema
                      - arts_and_culture
                      - nightclubs
                      - other_entertainment
                      - vehicle
                      - transport
                      - petrol
                      - parking_and_tolls
                      - service_stations
                      - vehicle_hire
                      - other_transport
                      - general_banking
                      - deposits_and_withdrawals
                      - interest
                      - refunds
                      - other_banking
                      - bars_and_pubs
                      - coffee
                      - restaurants
                      - other_eating_out
                      - business_insurance
                      - health_and_life_insurance
                      - house_or_home_insurance
                      - pet_insurance
                      - travel_insurance
                      - other_insurance
                      - vehicle_insurance
                      - loans
                      - car_loan
                      - credit_cards
                      - debt_management
                      - other_credit
                      - student_loan
                      - other_borrowing_and_loans
                      - flowers_and_gifts
                      - clothing_and_accessories
                      - technology
                      - general_stores
                      - online_shopping
                      - other_shopping
                      - other_income
                      - benefits_and_social_security
                      - child_support_income
                      - investment_income
                      - employment_income
                      - pension_income
                      - rental_income
                      - charity
                      - other_charity
                      - healthcare
                      - beauty
                      - sports_and_fitness
                      - pharmacies_and_health_products
                      - other_health_and_personal_care
                      - home_maintenance
                      - furniture_and_appliances
                      - gardening
                      - laundry
                      - other_home
                      - pets
                      - supermarkets_and_convenience
                      - speciality_groceries
                      - other_groceries
                      - accommodation_and_travel_agencies
                      - flights_and_air_travel_purchases
                      - other_travel
                      - other_holidays_and_travel
                      - investments
                      - pension_contribution
                      - savings
                      - other_pensions_savings_and_investments
                      - other_education
                      - education_and_school_fees
                      - transfers_in
                      - internal_transfers
                      - transfers_out
                      - other_transfers
                      - taxes
                      - mortgage_and_rent
                      - utilities
                      - telecom
                      - other_bills
                      - other_general
                Map Response:
                  value:
                    operation_id: categories_double_cat_get
                    data:
                    - name: dependent_costs
                      subcategories:
                      - name: other_dependent_costs
                      - name: children_and_babies
                      - name: childcare
                    - name: other_expenses
                      subcategories:
                      - name: business_expenses
                      - name: financial_and_legal_expenses
                      - name: postage_and_office_supplies
                      - name: other_expenses
                    - name: entertainment
                      subcategories:
                      - name: amusement
                      - name: hobbies
                      - name: books_and_reading
                      - name: events
                      - name: gambling
                      - name: media_subscriptions
                      - name: cinema
                      - name: arts_and_culture
                      - name: nightclubs
                      - name: other_entertainment
                    - name: transport
                      subcategories:
                      - name: vehicle
                      - name: transport
                      - name: petrol
                      - name: parking_and_tolls
                      - name: service_stations
                      - name: vehicle_hire
                      - name: other_transport
                    - name: banking
                      subcategories:
                      - name: general_banking
                      - name: deposits_and_withdrawals
                      - name: interest
                      - name: refunds
                      - name: other_banking
                    - name: eating_out
                      subcategories:
                      - name: bars_and_pubs
                      - name: coffee
                      - name: restaurants
                      - name: other_eating_out
                    - name: insurance
                      subcategories:
                      - name: business_insurance
                      - name: health_and_life_insurance
                      - name: house_or_home_insurance
                      - name: pet_insurance
                      - name: travel_insurance
                      - name: other_insurance
                      - name: vehicle_insurance
                    - name: borrowing_and_loans
                      subcategories:
                      - name: loans
                      - name: car_loan
                      - name: credit_cards
                      - name: debt_management
                      - name: other_credit
                      - name: student_loan
                      - name: other_borrowing_and_loans
                    - name: shopping
                      subcategories:
                      - name: flowers_and_gifts
                      - name: clothing_and_accessories
                      - name: technology
                      - name: general_stores
                      - name: online_shopping
                      - name: other_shopping
                    - name: income
                      subcategories:
                      - name: other_income
                      - name: benefits_and_social_security
                      - name: child_support_income
                      - name: investment_income
                      - name: employment_income
                      - name: pension_income
                      - name: rental_income
                    - name: charity
                      subcategories:
                      - name: charity
                      - name: other_charity
                    - name: health_and_personal_care
                      subcategories:
                      - name: healthcare
                      - name: beauty
                      - name: sports_and_fitness
                      - name: pharmacies_and_health_products
                      - name: other_health_and_personal_care
                    - name: home
                      subcategories:
                      - name: home_maintenance
                      - name: furniture_and_appliances
                      - name: gardening
                      - name: laundry
                      - name: other_home
                      - name: pets
                    - name: groceries
                      subcategories:
                      - name: supermarkets_and_convenience
                      - name: speciality_groceries
                      - name: other_groceries
                    - name: holidays_and_travel
                      subcategories:
                      - name: accommodation_and_travel_agencies
                      - name: flights_and_air_travel_purchases
                      - name: other_travel
                      - name: other_holidays_and_travel
                    - name: pensions_savings_and_investments
                      subcategories:
                      - name: investments
                      - name: pension_contribution
                      - name: savings
                      - name: other_pensions_savings_and_investments
                    - name: education
                      subcategories:
                      - name: other_education
                      - name: education_and_school_fees
                    - name: transfers
                      subcategories:
                      - name: transfers_in
                      - name: internal_transfers
                      - name: transfers_out
                      - name: other_transfers
                    - name: bills
                      subcategories:
                      - name: taxes
                      - name: mortgage_and_rent
                      - name: utilities
                      - name: telecom
                      - name: other_bills
                    - name: general
                      subcategories:
                      - name: other_general
        '400':
          description: The request contains an invalid payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
              example:
                operation_id: categories_double_cat_get
                code_id: failed_validation
                message: Failed validation
                errors:
                  client_id: This value should not be blank
        '401':
          description: Unauthorised request
        '405':
          description: An unexpected HTTP method was used
        5XX:
          description: An unexpected error occurred on the server side
    servers:
    - url: https://api-sandbox-us.thisisbud.com
components:
  schemas:
    GetModelsResponse:
      title: Models Response
      required:
      - operation_id
      - data
      properties:
        operation_id:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/schemas-CategorisationModel'
    OperationId:
      title: Operation Id Field
      type: string
      description: A unique identifier/reference associated with a given endpoint/operation
    GetCategoriesV2Response:
      title: Categories Response
      type: object
      description: Expected response structure for the get categories endpoint.
      required:
      - operation_id
      - data
      - metadata
      properties:
        operation_id:
          $ref: '#/components/schemas/OperationId'
        data:
          oneOf:
          - $ref: '#/components/schemas/CategoriesFlat'
          - $ref: '#/components/schemas/CategoriesMap'
        metadata:
          type: object
          required:
          - model
          properties:
            model:
              $ref: '#/components/schemas/schemas-CategorisationModel'
    CategoriesMap:
      title: Category Map
      description: A map of all the available categories and respective subcategories
      type: array
      items:
        title: Category
        description: A single category and its respective subcategories.
        type: object
        properties:
          name:
            title: Category Name
            description: The name of the category.
            type: string
          labels:
            title: Labels
            description: 'Cross category labels used in our engage products, all subcategories will inherit the labels of their parents.


              You can use these labels to understand how certain category determinations are being made, such as if a category considered essential.

              '
            type: array
            example:
            - essential
            items:
              type: string
          subcategories:
            title: Subcategories
            description: The respective subcategories for the given category.
            type: array
            items:
              title: subcategory
              description: A subcategory that belongs to the given category.
              type: object
              properties:
                name:
                  title: Subcategory Name
                  description: The name of the subcategory.
                  type: string
                labels:
                  title: Labels
                  description: 'Cross category labels used in our engage products.


                    You can use these labels to understand how certain category determinations are being made, such as if a category considered essential.

                    '
                  type: array
                  example:
                  - essential
                  items:
                    type: string
    CategoriesFlat:
      title: Category List
      type: object
      description: A list of all the available categories and subcategories.
      properties:
        categories:
          type: array
          description: List of all the available categories.
          items:
            type: string
        subcategories:
          type: array
          description: List of all the available subcategories.
          items:
            type: string
    schemas-CategorisationModel:
      title: Categorisation Model
      type: object
      description: Bud categorisation model.
      required:
      - name
      - description
      properties:
        name:
          type: string
          description: Name of the model.
        description:
          type: string
          description: Description of the model & use-cases it provides.
        deprecated:
          type: boolean
          description: A flag to mark a particular model version as deprecated (this field is omitted if the model is not deprecated).
    GetModelsResponse_2:
      title: Models Response
      required:
      - operation_id
      - data
      properties:
        operation_id:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/CategorisationModel'
    Errors:
      title: Array of Error Object
      description: Contains a list of error messages
      type: object
      additionalProperties:
        type: array
        items:
          type: string
    Error:
      title: Error Object
      type:
      - object
      - 'null'
      description: Contains a field specific error message
      additionalProperties:
        type: string
    GetCategoriesV2Response_2:
      title: Categories Response
      type: object
      description: Expected response structure for the get categories endpoint.
      required:
      - operation_id
      - data
      - metadata
      properties:
        operation_id:
          $ref: '#/components/schemas/OperationId'
        data:
          oneOf:
          - $ref: '#/components/schemas/CategoriesFlat'
          - $ref: '#/components/schemas/CategoriesMap'
        metadata:
          type: object
          required:
          - model
          properties:
            model:
              $ref: '#/components/schemas/CategorisationModel'
    CategorisationModel:
      title: Categorisation Model
      type: object
      description: Bud categorisation model.
      required:
      - name
      - description
      properties:
        name:
          type: string
          description: Name of the model.
        description:
          type: string
          description: Description of the model & use-cases it provides.
        deprecated:
          type: boolean
          description: A flag to mark a particular model version as deprecated (this field is omitted if the model is not deprecated).
    BadRequestResponse:
      title: Bad Request Response
      type: object
      description: Expected response structure
      required:
      - operation_id
      - code_id
      - message
      - errors
      properties:
        operation_id:
          $ref: '#/components/schemas/OperationId'
        code_id:
          type: string
          description: A descriptive enough string that is linked to the reason for the error.
        message:
          type: string
        errors:
          anyOf:
          - $ref: '#/components/schemas/Error'
          - $ref: '#/components/schemas/Errors'
    CategoriesResponse:
      title: Categories Response
      type: object
      description: Expected response structure for the get categories endpoint.
      required:
      - operation_id
      - data
      properties:
        operation_id:
          $ref: '#/components/schemas/OperationId'
        data:
          oneOf:
          - $ref: '#/components/schemas/CategoriesFlat'
          - $ref: '#/components/schemas/CategoriesMap'
  parameters:
    ClientId:
      in: header
      name: X-Client-Id
      schema:
        type: string
      required: true
      description: The API Client Identifier (Service Application Identifier).
      example: 8711bbef-b357-4c2d-97ca-0d9df4206e9a
  securitySchemes:
    Basic:
      type: http
      scheme: basic
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /v1/oauth/token
          scopes: {}
      description: "\nAuthentication flow:\n\n1. Perform OAuth2 Client Credentials authentication using API Credentials (`client_id`,`client_secret`) to obtain an `access_token` against `/v1/oauth/token` endpoint,\n2. Use `access_token` as Bearer Authorisation for every other API request,\n3. Include `X-Client-Id` (=client_id) within the header of every API request,\n4. Note that some of the requests may also require `X-Customer-Id` to be provided within the request header.\n\n### Examples\nObtain OAuth2 `access_token` and `refresh_token` using `grant_type=client_credentials` and HTTP Basic auth header\n\n```\ncurl --basic --user {{client_id}}:{{client_secret}} \\\n  -X POST https://api-sandbox.thisisbud.com/v1/oauth/token \\\n  -H 'Content-Type: application/x-www-form-urlencoded' \\\n  -d grant_type=client_credentials\n```\n\nSuccessful response:\n```\n{\n  \"operation_id\": \"oauth_token_post\",\n  \"data\": {\n    \"access_token\": \"dd0c17e3fd6d2ce94aa091257a3ea393b4f9b5cf3d3e998f07dc9826da86ff15\",\n    \"token_type\": \"bearer\",\n    \"expires_in\": 3600,\n    \"refresh_token\": \"fac32cca7559d9f6e8f1dfe9a99c71fa1dcfeb482bedf287d7934d2667ae54b3\"\n  }\n}\n```\n\nRefresh `access_token` token using `refresh_token` against `/v1/oauth/token` endpoint with `grant_type=refresh_token`\n\n```\ncurl -X POST \\\n  https://api-sandbox.thisisbud.com/v1/oauth/token \\\n  -H 'Content-Type: application/x-www-form-urlencoded' \\\n  -H 'X-Client-Id: {{client_id}}' \\\n  -d 'grant_type=refresh_token&refresh_token={{refresh_token}}'\n```\n\nSuccessful response:\n```\n{\n    \"operation_id\": \"oauth_token_post\",\n    \"data\": {\n        \"access_token\": \"cc0c17e3fd6d2ce94aa091257a3ea393b4f9b5cf3d3e998f07dc9826da86ff94\",\n        \"token_type\": \"bearer\",\n        \"expires_in\": 3600,\n        \"refresh_token\": \"ffc30cca7559d9f6e8f1dfe9a99c71fa1dcfeb482bedf287d7934d2667ae54b3\"\n    }\n}\n```\n"
x-refined-from:
- thisisbud-openapi-openapi.yml
- thisisbud-openapi-us-openapi.yml
x-tagGroups:
- name: ''
  tags:
  - OAuth2
  - Client Secrets
  - Authentication
- name: ''
  tags:
  - Create a Connection
  - Manage a Connection
  - Ingest First Party Data
  - Connect API
- name: ''
  tags:
  - Manage Customers
  - Customers API
- name: ''
  tags:
  - Enrichment Resources
  - Enrichment Totals
  - Enrichment API
- name: ''
  tags:
  - Retrieve Financial Data
  - Manage Financial Data
  - Manage Transaction Labels
  - Correct Financial Data
  - Financial Data API
- name: ''
  tags:
  - Spending Budgets
  - Savings Goals V2
  - Goals API
- name: ''
  tags:
  - Regular Payments Finder
  - Income Finder
  - Loan Finder
  - Debt Collection Finder
  - Product Finder
  - Subscription Finder
  - Smart Finders API
- name: ''
  tags:
  - Transaction Search
  - Intelligent Search API
- name: ''
  tags:
  - Customer Applications
  - Customer Application Links
  - Aggregation Buckets
  - Retrieve Affordability Report V2
  - Retrieve Affordability Report
  - Retrieve Affordability Risk Insights
  - Assess API
- name: ''
  tags:
  - Initiate Payment - Bud license
  - Initiate Payment - Client license
  - Manage Payments
  - Payments API
- name: ''
  tags:
  - Retrieve Customer Characteristics
  - Characteristics API
- name: ''
  tags:
  - Retrieve Actionable Insights
  - Custom Insights
  - Frontend Widgets
  - Insights API