Transact
Transact API

Firms

Server

Endpoints that provide information about firms.


Get firms

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

Retrieves information about adviser firms associated with the Resource Owner.

Authorisation Requirements

This endpoint requires a valid Transact access token with:

  • FIRM or NETWORK or INVESTMENT_MANAGER role
  • entity.read scope

Get firms › 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.

Get firms › 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 firms › Responses

Retrieved successfully.

​Firm[] · required

The list of firms.

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 a firm

GET
https://api.transact-online.co.uk
/firms/{firm_id}

Retrieves information about an adviser firm. The firm must be associated with the Resource Owner.

If the Resource Owner is itself an adviser firm, self can be used in place of the nine digit firm_id to return the Resource Owner's information.

Authorisation Requirements

This endpoint requires a valid Transact access token with:

  • FIRM or NETWORK or INVESTMENT_MANAGER role
  • entity.read scope

Get a firm › path Parameters

firm_id
​EntityIdOrSelf · pattern: ^([0-9]{9}|self)$ · required

The firm's Transact number.

Get a firm › 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 a firm › Responses

Retrieved successfully.

id
​EntityId · pattern: ^[0-9]{9}$ · required

The firm's Transact number.

name
​string · required

The name of the firm.

fca_number
​FcaNumber · pattern: ^[0-9]{6,7}$ · required

The firm's Firm Reference Number (FRN).

postcode
​string · required

The firm's postcode.