---
updatedAt: 2025-08-27T16:18:18.000Z
agentTools:
projectIndex: https://docs.moneyhubenterprise.com/v2.5/llms.txt
---
# Retrieve the holdings for an account with matched ISIN codes
Requires **accounts:read** scope.
# OpenAPI definition
```json
{
"openapi": "3.0.0",
"info": {
"description": "Documentation for the Moneyhub data API.
Authentication is via bearer token.
",
"title": "Moneyhub Data API",
"version": "2.0.0"
},
"security": [
{
"Bearer": []
}
],
"paths": {
"/accounts/{accountId}/holdings-with-matches": {
"get": {
"summary": "Retrieve the holdings for an account with matched ISIN codes",
"description": "Requires **accounts:read** scope.",
"parameters": [
{
"description": "The Account Id",
"in": "path",
"name": "accountId",
"required": true,
"example": "0b4e6488-6de0-420c-8f56-fee665707d57",
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"responses": {
"200": {
"description": "Successful Holdings Response",
"content": {
"application/json": {
"schema": {
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/HoldingWithMatches"
},
"type": "array"
},
"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": [
"holdings"
]
}
}
},
"servers": [
{
"url": "https://api.moneyhub.co.uk/v2.0"
}
],
"components": {
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"name": "Authorization",
"in": "header"
}
},
"schemas": {
"HoldingWithMatches": {
"additionalProperties": false,
"type": "object",
"properties": {
"date": {
"description": "Date of the valuation",
"example": "2018-07-11",
"format": "date",
"type": "string"
},
"id": {
"description": "The id of the holding",
"example": "6a8b01768a50b095a8c0445c1b080900f1096fd0b6e40863c6b82d63607c3bbe",
"type": "string"
},
"matched": {
"items": {
"additionalProperties": false,
"properties": {
"isin": {
"description": "The ISIN code of the match",
"example": "GB00B39TQT96",
"type": "string"
},
"name": {
"description": "The name of the match",
"example": "Dynamic Bond Fund Acc",
"type": "string"
},
"score": {
"example": 0.8,
"type": "number"
},
"priceGBP": {
"description": "The unit price of the holding match converted to GBP. The unitPrice is converted from the local currency (e.g. USD) to GBP on a daily basis during our import of holdings data.",
"example": 12.34,
"type": "number"
},
"price": {
"properties": {
"value": {
"description": "The unit price in minor units of the currency (e.g. pence for GBP)",
"example": 1234,
"type": "number"
},
"currency": {
"description": "The currency of the matched holding",
"example": "GBP",
"type": "string"
}
},
"required": [
"value",
"currency"
],
"type": "object"
},
"date": {
"description": "Date of the valuation",
"example": "2018-07-11",
"format": "date",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"codes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"example": "GB00B39TQT96",
"type": "string"
},
"type": {
"enum": [
"ISIN",
"SEDOL",
"MEX"
],
"example": "ISIN",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"name": {
"example": "Dynamic Bond Fund",
"type": "string"
},
"quantity": {
"description": "The total number of units. This value reflects the quantity of the holding in its local currency context and is used to calculate the total value as unitPrice * quantity.",
"example": 100,
"type": "number"
},
"total": {
"properties": {
"value": {
"description": "The value of the total in minor units of the currency, eg. pennies for GBP.",
"example": 123400,
"type": "number"
},
"currency": {
"description": "The currency of the total.",
"example": "GBP",
"type": "string"
}
},
"required": [
"value",
"currency"
],
"type": "object"
},
"unitPrice": {
"properties": {
"value": {
"description": "The price per unit of the holding. Provided by the holdings data source in its original currency.",
"example": 1234,
"type": "number"
},
"currency": {
"description": "The currency of the unit price.",
"example": "GBP",
"type": "string"
}
},
"required": [
"value",
"currency"
],
"type": "object"
},
"currency": {
"description": "The currency of the holding",
"example": "GBP",
"type": "string"
}
},
"required": [
"name",
"quantity",
"unitPrice",
"total",
"codes",
"id",
"matched"
]
},
"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"
},
"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"
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```