Valuations

Server

Download schema

Endpoints that provide valuation data.

Get valuations

GET

https://api.transact-online.co.uk

/valuations

Retrieves investor portfolio valuation data for portfolios associated with the Resource Owner.

Data is as of the end of the previous business day.

Notes

Wrappers (and holdings) are included where any of the following conditions are met:

The wrapper is OPEN or CLOSING
The wrapper is CLOSED and
- it was closed within the last 30 days
- or a transaction was added within the last 30 days
- or a holding exists

Current wrapper state (OPEN, CLOSING, CLOSED) and effective dates for each state is provided.

Optionally firm_ids, adviser_ids and investor_portfolio_ids may be specified.

Optionally exclude_closed_portfolios may be specified. If true, this overrides the above conditional logic. Portfolios where all contained wrappers are CLOSED are excluded.

Optionally exclude_empty_gias may be specified. If true, General Investment Account wrappers (GIAs) that have no transactions are excluded.

Data is prepared for consumption each weekday and remains static throughout the day. It is recommended that you request data after 6 am UK local time.

Note that in the UAT environment, this endpoint returns one investor portfolio per page. In the production environment each page contains multiple investor portfolios.

Authorisation Requirements

This endpoint requires a valid Transact access token with:

FIRM or NETWORK role
valuation.read and entity.read scopes

Get valuations › query Parameters

cursor

string · style: form

Opaque cursor to the result page to include in the response. Appropriate values for this field may be retrieved from a response object's first, prev, next, last, and self fields.

exclude_closed_portfolios

boolean

Option to suppress portfolios where all contained wrappers are CLOSED. Default value is false.

Default: false

exclude_empty_gias

boolean

Option to suppress GIAs that contain no transactions. Default value is false.

Default: false

firm_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of firm Transact numbers to filter on.

adviser_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of adviser Transact numbers to filter on.

investor_portfolio_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of investor Transact numbers to filter on.

Get valuations › Headers

Transact-Api-Version

string · enum · required

The targeted API version. This must be set to the current version of the API.

Enum values:

2026-05-12

Authorization

string · required

Transact access token, provided using the Bearer HTTP authentication scheme.

Get valuations › Responses

Retrieved Successfully.

ValuationPage

ValuationPortfolio[] · required

The list of investor portfolios.

self

string · cursor

Pagination cursor pointing to the current page.

first

string · cursor

Pagination cursor pointing to the first page.

prev

string · cursor

Pagination cursor pointing to the previous page.

next

string · cursor

Pagination cursor pointing to the next page.

last

string · cursor

Pagination cursor pointing to the last page.

object

Object containing the applied query filters.

GET/valuations

curl --request GET \
  --url https://api.transact-online.co.uk/valuations \
  --header 'Authorization: Bearer $YOUR_API_KEY' \
  --header 'Transact-Api-Version: 2026-05-12'

shell

Example Responses

{
  "items": [
    {
      "id": "333333331",
      "adviser_id": "222222221",
      "firm_id": "111111111",
      "wrappers": [
        {
          "id": "IH00000001",
          "type": "GENERAL_INVESTMENT_ACCOUNT",
          "name": "Savings for John",
          "status": "OPEN",
          "opening_date": "2024-01-31",
          "closing_date": null,
          "closed_date": null,
          "holdings": [
            {
              "investment_id": "IP00000002",
              "investment_name": "Cash",
              "isin": "",
              "is_cash": true,
              "price": 1,
              "price_date": "2000-03-15",
              "units": 100.95
            },
            {
              "investment_id": "IP12345678",
              "investment_name": "Investments Ltd",
              "isin": "GB1234567890",
              "is_cash": false,
              "price": 1.1234,
              "price_date": "2025-01-30",
              "units": 200.1234
            }
          ]
        },
        {
          "id": "IH00000002",
          "type": "ISA_STOCKS_AND_SHARES",
          "name": "",
          "status": "OPEN",
          "opening_date": "2024-01-31",
          "closing_date": null,
          "closed_date": null,
          "holdings": [
            {
              "investment_id": "IP12345678",
              "investment_name": "Investments Ltd",
              "isin": "GB1234567890",
              "is_cash": false,
              "price": 1.1234,
              "price_date": "2025-01-30",
              "units": 200.1234
            }
          ]
        },
        {
          "id": "IH00000003",
          "type": "GENERAL_INVESTMENT_ACCOUNT",
          "name": "",
          "status": "CLOSING",
          "opening_date": "2023-01-31",
          "closing_date": "2025-01-31",
          "closed_date": null,
          "holdings": []
        },
        {
          "id": "IH00000004",
          "type": "GENERAL_INVESTMENT_ACCOUNT",
          "name": "",
          "status": "CLOSED",
          "opening_date": "2023-01-31",
          "closing_date": "2025-01-31",
          "closed_date": "2025-02-01",
          "holdings": []
        }
      ]
    }
  ],
  "self": "1234567abc-defg-hijk-lmno-pqrstuvwxyz",
  "first": "2234567abc-defg-hijk-lmno-pqrstuvwxyz",
  "prev": "334567abc-defg-hijk-lmno-pqrstuvwxyz",
  "next": "434567abc-defg-hijk-lmno-pqrstuvwxyz",
  "last": "534567abc-defg-hijk-lmno-pqrstuvwxyz",
  "query": {}
}

json

application/json

Remuneration

Get valuations

GET

https://api.transact-online.co.uk

/valuations

Retrieves investor portfolio valuation data for portfolios associated with the Resource Owner.

Data is as of the end of the previous business day.

Notes

Wrappers (and holdings) are included where any of the following conditions are met:

The wrapper is OPEN or CLOSING
The wrapper is CLOSED and
- it was closed within the last 30 days
- or a transaction was added within the last 30 days
- or a holding exists

Current wrapper state (OPEN, CLOSING, CLOSED) and effective dates for each state is provided.

Optionally firm_ids, adviser_ids and investor_portfolio_ids may be specified.

Optionally exclude_closed_portfolios may be specified. If true, this overrides the above conditional logic. Portfolios where all contained wrappers are CLOSED are excluded.

Optionally exclude_empty_gias may be specified. If true, General Investment Account wrappers (GIAs) that have no transactions are excluded.

Data is prepared for consumption each weekday and remains static throughout the day. It is recommended that you request data after 6 am UK local time.

Note that in the UAT environment, this endpoint returns one investor portfolio per page. In the production environment each page contains multiple investor portfolios.

Authorisation Requirements

This endpoint requires a valid Transact access token with:

FIRM or NETWORK role
valuation.read and entity.read scopes

Get valuations › query Parameters

cursor

string · style: form

Opaque cursor to the result page to include in the response. Appropriate values for this field may be retrieved from a response object's first, prev, next, last, and self fields.

exclude_closed_portfolios

boolean

Option to suppress portfolios where all contained wrappers are CLOSED. Default value is false.

Default: false

exclude_empty_gias

boolean

Option to suppress GIAs that contain no transactions. Default value is false.

Default: false

firm_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of firm Transact numbers to filter on.

adviser_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of adviser Transact numbers to filter on.

investor_portfolio_ids

EntityId[] · maxItems: 50 · unique · style: form

The list of investor Transact numbers to filter on.

Get valuations › Headers

Transact-Api-Version

string · enum · required

The targeted API version. This must be set to the current version of the API.

Enum values:

2026-05-12

Authorization

string · required

Transact access token, provided using the Bearer HTTP authentication scheme.

Get valuations › Responses

Retrieved Successfully.

ValuationPage

ValuationPortfolio[] · required

The list of investor portfolios.

self

string · cursor

Pagination cursor pointing to the current page.

first

string · cursor

Pagination cursor pointing to the first page.

prev

string · cursor

Pagination cursor pointing to the previous page.

next

string · cursor

Pagination cursor pointing to the next page.

last

string · cursor

Pagination cursor pointing to the last page.

object

Object containing the applied query filters.