Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TM Forum partyAccount API

The partyAccount API from TM Forum — 2 operation(s) for partyaccount.

TM Forum partyAccount API is one of 38 APIs that TM Forum publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include partyAccount. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 2 paths, and defines 21 schemas. It is described by OpenAPI 3.0.1, at version 5.0.0.

Requests are made against a single base URL, https://serverRoot/productCatalogManagement/v5/.

5 operations 2 paths 21 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
5.0.0
Server
https://serverRoot/productCatalogManagement/v5/
Resource Areas
1

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

partyAccount 5
GET
/partyAccount
List or find PartyAccount objects
listPartyAccount 3 params → 200400401403404405409500
POST
/partyAccount
Creates a PartyAccount
createPartyAccount 1 param → 201400401403405409500
GET
/partyAccount/{id}
Retrieves a PartyAccount by ID
retrievePartyAccount 2 params → 200400401403404405409500
PATCH
/partyAccount/{id}
Updates partially a PartyAccount
patchPartyAccount 2 params → 200400401403404405409500
DELETE
/partyAccount/{id}
Deletes a PartyAccount
deletePartyAccount 1 param → 204400401403404405409500

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are PartyAccount (21 properties), PartyAccount_Create (19 properties), BillingCycleSpecificationRefOrValue (18 properties), PartyAccount_Update (18 properties). Each schema is shown below with its type and property counts.

Error
object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
8 properties 2 required
AccountBalance
object
Balances linked to the account
6 properties 3 required
ContactMedium
object
Indicates the contact medium that could be used to contact the party.
7 properties
FinancialAccountRef
object
AccountReceivable reference. An account of money owed by a party to another entity in exchange for goods or services that have been delivered or used. An accou…
8 properties 1 required
PaymentMethodRef
object
PaymentMethod reference. A payment method defines a specific mean of payment (e.g direct debit).
7 properties 1 required
TimePeriod
object
A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
2 properties
MediumCharacteristic
object
Describes the contact medium characteristics that could be used to contact a party (an individual or an organization)
14 properties
PartyAccount
object
Account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account.
21 properties 2 required
PartyAccount_Update
object
Account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account. Skip…
18 properties 2 required
BillFormatRefOrValue
object
An attachment by value or by reference.
9 properties 2 required
PartyAccount_Create
object
Account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account. Skip…
19 properties 2 required
BillingCycleSpecificationRefOrValue
object
An attachment by value or by reference.
18 properties 2 required
PaymentPlan
object
Defines a plan for payment (when a party wants to spread his payments)
11 properties
BillPresentationMediaRefOrValue
object
An attachment by value or by reference.
9 properties 2 required
AccountTaxExemption
object
Proof of freedom from taxes imposed by a taxing jurisdiction
7 properties 2 required
Money
object
A base / value business entity used to represent money
2 properties
Contact
object
An individual or an organization used as a contact point for a given account and accessed via some contact medium.
9 properties 2 required
AccountRef
object
Account reference. A account may be a party account or a financial account.
8 properties 1 required
BillStructure
object
The structure of the bill for party accounts (billing or settlement).
6 properties
AccountRelationship
object
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
6 properties 2 required
RelatedParty
object
Related Entity reference. A related party defines party or party role linked to a specific entity.
8 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tm-forum-partyaccount-api-openapi.yml Raw ↑

Other APIs TM Forum publishes across the network.

TM Forum agreement API
TM Forum agreementSpecification API
TM Forum billFormat API
TM Forum billingAccount API
TM Forum billingCycleSpecification API
TM Forum billPresentationMedia API
TM Forum cancelProductOrder API
TM Forum cancelServiceOrder API
TM Forum category API
TM Forum customer API
TM Forum events subscription API
TM Forum exportJob API