Moneyhub

Moneyhub spending goals API

The spending goals API from Moneyhub — 2 operation(s) for spending goals.

GitHub OpenAPI

Operations 5

GET /spending-goals Retrieve all spending goals for a user #
POST /spending-goals Create a single spending goal for a user #
GET /spending-goals/{goalId} Retrieve a single spending goal #
PATCH /spending-goals/{goalId} Update a single spending goal #
DELETE /spending-goals/{goalId} Delete a single spending goal #

Documentation

📖
Documentation
https://docs.moneyhubenterprise.com/docs/introduction
📖
APIReference
https://moneyhub.github.io/api-docs/
📖
GettingStarted
https://docs.moneyhubenterprise.com/docs/getting-started
📖
Documentation
https://www.moneyhub.com/apis/data-intelligence

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/moneyhub/refs/heads/main/openapi/moneyhub-spending-goals-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/moneyhub/refs/heads/main/json-schema/moneyhub-spending-goal-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/moneyhub/refs/heads/main/json-schema/moneyhub-spending-goal-post-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/moneyhub/refs/heads/main/json-schema/moneyhub-spending-goal-patch-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/moneyhub/refs/heads/main/json-schema/moneyhub-links-schema.json

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/moneyhub:moneyhub-spending-goals-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.

GitHub Google LinkedIn

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

OpenAPI Specification

moneyhub-spending-goals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'Documentation for the Moneyhub data API.

    Authentication is via bearer token.'
  title: Moneyhub Data spending goals API
  version: 2.0.0
  x-build-sha: 5d5191d
servers:
- url: https://api.moneyhub.co.uk/v2.0
security:
- Bearer: []
tags:
- name: spending goals
paths:
  /spending-goals:
    get:
      summary: Retrieve all spending goals for a user
      description: Requires **spending_goals:read** scope.
      parameters:
      - description: The total number of records to retrieve
        in: query
        name: limit
        schema:
          type: integer
          maximum: 1000
          minimum: 0
      - description: The offset at which to start retrieving records
        in: query
        name: offset
        schema:
          type: integer
          maximum: 1000000000
          minimum: 0
      responses:
        '200':
          description: Successful Spending Goals Response
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/SpendingGoal'
                    type: array
                  links:
                    $ref: '#/components/schemas/Links'
                  meta:
                    type: object
                type: object
      tags:
      - spending goals
      operationId: getSpendingGoals
      x-operation-id-source: derived
    post:
      summary: Create a single spending goal for a user
      description: Requires **spending_goals:read** and **spending_goals:write:all** scopes.
      responses:
        '200':
          description: Successful Spending Goal Response
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/SpendingGoal'
                  links:
                    $ref: '#/components/schemas/Links'
                  meta:
                    type: object
                type: object
        '400':
          description: Unsuccessful Response - Bad request - Missing query parameters - Missing body properties
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Unsuccessful Response - Forbidden - Invalid scopes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - spending goals
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SpendingGoalPost'
      operationId: postSpendingGoals
      x-operation-id-source: derived
  /spending-goals/{goalId}:
    get:
      summary: Retrieve a single spending goal
      description: Requires **spending_goals:read** scope.
      parameters:
      - description: The Goal Id
        in: path
        name: goalId
        required: true
        x-example: 39577c49-350f-45a4-8ec3-48ce205585fb
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Successful Spending Goal Response
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/SpendingGoal'
                  links:
                    $ref: '#/components/schemas/Links'
                  meta:
                    type: object
                type: object
        '401':
          description: Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Unsuccessful Response - Forbidden - Invalid scopes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unsuccessful Response - Resource Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - spending goals
      operationId: getSpendingGoalsByGoalId
      x-operation-id-source: derived
    patch:
      summary: Update a single spending goal
      description: Requires **spending_goals:read spending_goals:write** scope.
      parameters:
      - description: The Goal Id
        in: path
        name: goalId
        required: true
        x-example: 39577c49-350f-45a4-8ec3-48ce205585fb
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Successful Spending Goal Response
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/SpendingGoal'
                  links:
                    $ref: '#/components/schemas/Links'
                  meta:
                    type: object
                type: object
        '401':
          description: Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Unsuccessful Response - Forbidden - Invalid scopes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unsuccessful Response - Resource Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - spending goals
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SpendingGoalPatch'
      operationId: patchSpendingGoalsByGoalId
      x-operation-id-source: derived
    delete:
      summary: Delete a single spending goal
      description: Requires **spending_goals:write:all** scope.
      parameters:
      - description: The Goal Id
        in: path
        name: goalId
        required: true
        x-example: 39577c49-350f-45a4-8ec3-48ce205585fb
        schema:
          type: string
          format: uuid
      responses:
        '204':
          description: Successful Spending Goal Response
        '401':
          description: Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Unsuccessful Response - Forbidden - Invalid scopes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unsuccessful Response - Resource Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - spending goals
      operationId: deleteSpendingGoalsByGoalId
      x-operation-id-source: derived
components:
  schemas:
    SpendingGoal:
      additionalProperties: false
      type: object
      properties:
        categoryId:
          example: std:4b0255f0-0309-4509-9e05-4b4e386f9b0d
          type: string
          pattern: ^(std|cus):(\w|-)+$
        dateCreated:
          example: '2018-07-11T00:00:00.000Z'
          format: date-time
          type: string
        periodType:
          example: monthly
          type: string
          enum:
          - monthly
          - annual
        periodStart:
          example: '01'
          type: string
          pattern: ^(0?[1-9]|[12][0-9]|3[01])(-(0?[1-9]|1[012]))?$
        id:
          description: The unique id of the spending goal
          type: string
          example: 0b4e6488-6de0-420c-8f56-fee665707d57
        amount:
          properties:
            value:
              description: The value of the amount in minor units of the currency, eg. pennies for GBP.
              example: 40000
              type: integer
              minimum: 0
            majorUnits:
              description: The major units of the value, based on the values currency, eg. pounds for GBP.
              example: 400
              type: integer
            minorUnits:
              description: The minor units of the value, based on the values currency, eg. pennies for GBP.
              example: 0
              type: integer
            currency:
              description: The currency of the amount.
              example: GBP
              type: string
          required:
          - value
          - currency
          type: object
        spending:
          items:
            additionalProperties: false
            properties:
              date:
                example: 2018-07
                type: string
              spent:
                description: The spending analysis amount of the specified month expressed in minor units of the currency.
                example: -35000
                type: integer
            required:
            - date
            - spent
            type: object
          type: array
      required:
      - id
      - dateCreated
      - categoryId
      - amount
      - periodStart
      - periodType
      - spending
    Links:
      additionalProperties: false
      properties:
        next:
          description: The url to retrieve the next page of results from
          format: uri
          type: string
        prev:
          description: The url to retrieve the previous page of results from
          format: uri
          type: string
        self:
          description: The url of the current resource(s)
          format: uri
          type: string
      required:
      - self
      type: object
    SpendingGoalPost:
      properties:
        categoryId:
          description: The id of the category for the spending goal, either from the /categories endpoint or **std:all**
          type: string
          example: std:379c7ed2-27f3-401f-b581-f6507934f0f0
        periodType:
          description: The period type of the goal, can be annual or monthly
          example: monthly
          type: string
          enum:
          - monthly
          - annual
        periodStart:
          description: You can set a goal period to start on a certain date. DD when periodType is monthly, DD-MM when periodType is annual
          example: '01'
          type: string
          pattern: ^(0?[1-9]|[12][0-9]|3[01])(-(0?[1-9]|1[012]))?$
        amount:
          properties:
            value:
              description: The amount of the spending goal in minor units of the currency, eg. pennies for GBP.
              example: 500000
              type: integer
              exclusiveMinimum: 0
          required:
          - value
          type: object
      example:
        categoryId: std:379c7ed2-27f3-401f-b581-f6507934f0f0
        amount:
          value: 50000
      type: object
      required:
      - categoryId
      - amount
    Error:
      additionalProperties: false
      properties:
        code:
          description: The error code
          type: string
        message:
          description: The error message
          type: string
        correlationId:
          description: Id that identifies the request and can be used to ask for more details related to the error
          type: string
        id:
          description: Id of the resource
          type: string
        userId:
          description: UserId of the resource
          type: string
      required:
      - code
      type: object
    SpendingGoalPatch:
      properties:
        categoryId:
          description: The id of the category the spending goal should be created for
          type: string
          example: std:379c7ed2-27f3-401f-b581-f6507934f0f0
        amount:
          properties:
            value:
              description: The amount of the spending goal in minor units of the currency, eg. pennies for GBP.
              example: 300
              type: integer
              exclusiveMinimum: 0
          required:
          - value
          type: object
      example:
        categoryId: std:379c7ed2-27f3-401f-b581-f6507934f0f0
        amount:
          value: 300
      type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header