1. Overview

partyroletmfwebservices Documentation

1.1. Version information

Version : 1.0.0

1.2. URI scheme

Host : hostname
BasePath : /partyroletmfwebservices/v1

1.3. Tags

  • Party Role : Pr Party Role Controller

1.4. Produces

  • application/json

2. Security

2.1. oauth2_password

Type : oauth2
Flow : password
Token URL : https://localhost:9002/authorizationserver/oauth/token

Name

basic

2.2. oauth2_client_credentials

Type : oauth2
Flow : application
Token URL : https://localhost:9002/authorizationserver/oauth/token

Name

extended

3. Resources

3.1. Party Role

Pr Party Role Controller

3.1.1. Creates a PartyRole

POST /partyRole
Description

This operation creates a PartyRole entity.

Parameters
Type Name Description Schema

Body

partyRole
required

The PartyRole to be created

PartyRole

Responses
HTTP Code Description Schema

200

OK

PartyRole

201

Created

PartyRole

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

No Content

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.2. List or find PartyRole objects

GET /partyRole
Description

This operation list or find PartyRole entities

Parameters
Type Name Description Schema

Query

fields
optional

Comma-separated properties to be provided in response

string

Query

limit
optional

Requested number of resources to be provided in response

integer(int32)

Query

name
optional

For filtering: The name of PartyRole

string

Query

offset
optional

Requested index for start of resources to be provided in response

integer(int32)

Query

status
optional

For filtering: The status of PartyRole

string

Responses
HTTP Code Description Schema

200

Success

< PartyRole > array

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.3. Retrieves a PartyRole by ID

GET /partyRole/{id}
Description

This operation retrieves a PartyRole entity. Attribute selection is enabled for all first level attributes.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the PartyRole

string

Query

fields
optional

Comma-separated properties to provide in response

string

Responses
HTTP Code Description Schema

200

Success

PartyRole

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.4. Deletes a PartyRole

DELETE /partyRole/{id}
Description

This operation deletes a PartyRole entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the PartyRole

string

Responses
HTTP Code Description Schema

200

OK

No Content

204

Deleted

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.5. Updates partially a PartyRole

PATCH /partyRole/{id}
Description

This operation updates partially a PartyRole entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the PartyRole

string

Body

partyRole
required

The PartyRole to be updated

PartyRole

Responses
HTTP Code Description Schema

200

Updated

PartyRole

204

No Content

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

4. Definitions

4.1. AccountRef

Account reference. A account may be a party account or a financial account.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

description
optional

Detailed description of the account

string

href
optional

Reference of the account

string

id
optional

Unique identifier of the account

string

name
required

Name of the account

string

4.2. AgreementRef

Agreement reference. An agreement represents a contract or arrangement, either written or verbal and sometimes enforceable by law, such as a service level agreement or a customer price agreement. An agreement involves a number of other business entities, such as products, services, and resources and/or their specifications.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the agreement

string

4.3. Characteristic

Describes a given characteristic of an object or entity through a name/value pair.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

name
required

Name of the characteristic

string

value
required

The value of the characteristic

object

valueType
optional

Data type of the value of the characteristic

string

4.4. ContactMedium

Indicates the contact medium that could be used to contact the party.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

characteristic
required

Any additional characteristic(s) of this contact medium

MediumCharacteristic

mediumType
required

Type of the contact medium, such as: email address, telephone number, postal address

string

preferred
optional

If true, indicates that is the preferred contact medium

boolean

validFor
optional

The time period that the contact medium is valid for

TimePeriod

4.5. CreditProfile

Credit profile for the party (containing credit scoring, …). By default only the current credit profile is retrieved. It can be used as a list to give the party credit profiles history, the first one in the list will be the current one.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

creditProfileDate
required

The date the profile was established

string(date-time)

creditRiskRating
optional

This is an integer whose value is used to rate the risk

integer(int32)

creditScore
optional

A measure of a person or organizations creditworthiness calculated on the basis of a combination of factors such as their income and credit history

integer(int32)

validFor
required

The period for which the profile is valid

TimePeriod

4.6. Error

Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name.

string

code
required

Application relevant detail, defined in the API or a common list.

string

message
optional

More details and corrective actions related to the error which can be shown to a client user.

string

reason
required

Explanation of the reason for the error which can be shown to a client user.

string

referenceError
optional

URI of documentation describing the error.

string

status
optional

HTTP Error code extension

string

4.7. MediumCharacteristic

Describes the contact medium characteristics that could be used to contact a party (an individual or an organization)

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

city
optional

The city

string

contactType
optional

The type of contact, for example: phone number such as mobile, fixed home, fixed office. postal address such as shipping instalation…

string

country
optional

The country

string

emailAddress
optional

Full email address in standard format

string

faxNumber
optional

The fax number of the contact

string

phoneNumber
optional

The primary phone number of the contact

string

postCode
optional

Postcode

string

socialNetworkId
optional

Identifier as a member of a social network

string

stateOrProvince
optional

State or province

string

street1
optional

Describes the street

string

street2
optional

Complementary street description

string

4.8. PartyRole

The part played by a party in a given context.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

account
optional

< AccountRef > array

agreement
optional

< AgreementRef > array

characteristic
optional

Describes the characteristic of a party role.

< Characteristic > array

contactMedium
optional

< ContactMedium > array

creditProfile
optional

< CreditProfile > array

engagedParty
optional

RelatedParty

href
optional

Url used to reference the party role.

string

id
optional

Unique identifier for PartyRoles

string

name
optional

A word, term, or phrase by which the PartyRole is known and distinguished from other PartyRoles.

string

paymentMethod
optional

< PaymentMethodRef > array

relatedParty
optional

< RelatedParty > array

status
optional

Used to track the lifecycle status of the party role.

string

statusReason
optional

A string providing an explanation on the value of the status lifecycle. For instance if the status is Rejected, statusReason will provide the reason for rejection.

string

validFor
optional

The time period that the PartyRole is valid for.

TimePeriod

4.9. PaymentMethodRef

PaymentMethod reference. A payment method defines a specific mean of payment (e.g direct debit).

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the payment mean

string

id
required

Unique identifier of the payment mean

string

name
optional

Name of the payment mean

string

4.10. RelatedParty

Related Entity reference. A related party defines party or party role linked to a specific entity.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
required

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the related entity.

string

role
optional

Role played by the related party

string

4.11. TimePeriod

A period of time, either as a deadline (endDateTime only) a startDateTime only, or both

Name Description Schema

endDateTime
optional

End of the time period, using IETC-RFC-3339 format

string(date-time)

startDateTime
optional

Start of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an end

string(date-time)