Fees

Get a fee collection by ID

Returns the fee collection identified by fee_collection_id, including its status and the amount processed so far.

A fee collection moves through PROCESSING, then either FINALISED once the fees have been collected from the account and transferred to you, or CANCELLED.

See the Fee collection guide (TOL / BYOL) for the collection lifecycle and webhook events.

get/fees/collections/{fee_collection_id}

Request

  • Base URL: https://sandbox.upvest.co
  • URL: https://sandbox.upvest.co/fees/collections/{fee_collection_id}
  • Auth: OAuth 2 (client credentials, token URL https://sandbox.upvest.co/auth/token, scopes: fees:read, fees:admin)

Response

OK

idstring uuid required

The unique identifier of the fee collection, as a UUID.

created_atstring date-time required

Date and time when the resource was created. RFC 3339-5, ISO8601 UTC

updated_atstring date-time required

Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC

account_idstring uuid required

Universally Unique Identifier (UUID) of the account.

account_group_idstring uuid required

Universally Unique Identifier (UUID) of the account group.

type'SERVICE_FEE' | 'SERVICE_FEE_LIQUIDATION' required

Type of the fee collection.

  • SERVICE_FEE — Service fee intake in a pre-defined cadence, for example monthly.
  • SERVICE_FEE_LIQUIDATION — Service fee intake resulting from a portfolio liquidation.
collection_amountstring required

A positive cash amount, as a decimal string with up to two decimal places.

currency'EUR' | 'GBP' required

Alphabetic three-letter ISO 4217 currency code.

  • EUR — Euro.
  • GBP — Pound Sterling.
status'PROCESSING' | 'FINALISED' | 'CANCELLED' required

Status of the fee collection.

  • PROCESSING — The fee collection is in progress.
  • FINALISED — The fees have been collected from the account and the funds transferred to the client.
  • CANCELLED — The fee collection was cancelled.
period_startstring date required

The start date of the fee collection period, as a RFC 3339, section 5.6 full date in YYYY-MM-DD format.

period_endstring date required

The end date of the fee collection period, as a RFC 3339, section 5.6 full date in YYYY-MM-DD format.

replaced_collection_idstring uuid

The unique identifier of the fee collection, as a UUID.

Changes

No recorded changes to this operation across all 25 revisions of this API.