PartyIDSource (FIX tag 447)

charFIX 4.4FIX 5.0 SP2

PartyIDSource (tag 447) is a char field defined in FIX 4.4 and FIX 5.0 SP2. It appears in 44 message types, always optionally. It is an enumerated field with 18 defined values.

At a glance

Tag: 447
Name: PartyIDSource
Datatype: char
Dialects: FIX 4.4 and FIX 5.0 SP2
Messages: 44
Valid values: 18

What the specification says

FIX 4.4

Identifies class or source of the PartyID (448) value. Required if PartyID is specified. Note: applicable values depend upon PartyRole (452) specified. See "Appendix 6-G – Use of <Parties> Component Block"

FIX 5.0 SP2

Identifies class or source of the PartyID (448) value. Required if PartyID is specified. Note: applicable values depend upon PartyRole (452) specified.

Descriptions are quoted from the FIX Orchestra sources under the Apache 2.0 licence.

A real message using tag 447

NewOrderSingle · FIX 4.4

Tag	Field	Wire value	Meaning
8	BeginString	FIX.4.4
9	BodyLength	153
35	MsgType	D	Order – Single
49	SenderCompID	BOARTEAM
56	TargetCompID	COUNTERPARTY
34	MsgSeqNum	2
52	SendingTime	20240101-12:00:00.000
11	ClOrdID	ORD-10042
453	NoPartyIDs2 entries	2	repeating group
448	PartyID	EXAMPLE
447	PartyIDSource	B	BIC (Bank Identification Code—Swift managed) code (ISO 9362 - See "Appendix 6-B")
448	PartyID	EXAMPLE
447	PartyIDSource	B	BIC (Bank Identification Code—Swift managed) code (ISO 9362 - See "Appendix 6-B")
54	Side	1	Buy
60	TransactTime	20240101-12:00:00.000
40	OrdType	1	Market
10	CheckSum	020

Edit and decode it yourself

Shown with | separators for readability. On the wire FIX uses SOH (0x01), an invisible control byte — and because BodyLength and CheckSum are computed over the actual bytes, the two forms have different checksums. Both are valid and both decode here.

Open in the full decoder →

Generated from the FIX 4.4 dictionary and verified at build time: it parses and validates with no issues. Open the decoder to try your own message.

Valid values

A value outside this list is not a parse error — the message still decodes — but validate() reports it as validate/value-not-in-enum.

Value	Meaning	Symbolic name
B	BIC (Bank Identification Code—Swift managed) code (ISO 9362 - See "Appendix 6-B")	BIC
C	Generally accepted market participant identifier (e.g. NASD mnemonic)	GENERALLY_ACCEPTED_MARKET_PARTICIPANT_IDENTIFIER
D	Proprietary/Custom code	PROPRIETARY_CUSTOM_CODE
E	ISO Country Code	ISO_COUNTRY_CODE
F	Settlement Entity Location (note if Local Market Settlement use "E = ISO Country Code") (see "Appendix 6-G" for valid values)	SETTLEMENT_ENTITY_LOCATION
G	MIC (ISO 10383 - Market Identifier Code) (See "Appendix 6-C")	MIC
H	CSD participant/member code (e.g. Euroclear, DTC, CREST or Kassenverein number)	CSD_PARTICIPANT_MEMBER_CODE
1	Korean Investor ID	KOREAN_INVESTOR_ID
2	Taiwanese Qualified Foreign Investor ID QFII / FID	TAIWANESE_QUALIFIED_FOREIGN_INVESTOR_ID_QFII / TAIWANESE_QUALIFIED_FOREIGN_INVESTOR_ID_QFII_FID
3	Taiwanese Trading Account	TAIWANESE_TRADING_ACCOUNT / TAIWANESE_TRADING_ACCT
4	Malaysian Central Depository (MCD) number	MALAYSIAN_CENTRAL_DEPOSITORY / MALAYSIAN_CENTRAL_DEPOSITORY_NUMBER
5	Chinese B Share (Shezhen and Shanghai)	CHINESE_B_SHARE / CHINESE_INVESTOR_ID
6	UK National Insurance or Pension Number	UK_NATIONAL_INSURANCE_OR_PENSION_NUMBER
7	US Social Security Number	US_SOCIAL_SECURITY_NUMBER
8	US Employer Identification Number	US_EMPLOYER_IDENTIFICATION_NUMBER / US_EMPLOYER_OR_TAX_ID_NUMBER
9	Australian Business Number	AUSTRALIAN_BUSINESS_NUMBER
A	Australian Tax File Number	AUSTRALIAN_TAX_FILE_NUMBER
I	Directed broker three character acronym as defined in ISITC ‘ETC Best Practice’ guidelines document	DIRECTED_BROKER_THREE_CHARACTER_ACRONYM_AS_DEFINED_IN_ISITC_ETC_BEST_PRACTICE_GUIDELINES_DOCUMENT

Where tag 447 appears

Requiredness is a property of the message, not of the field: the same tag can be optional in one message and conditionally required in another.

Message	MsgType	FIX 4.4	FIX 5.0 SP2	Where in the message
AdjustedPositionReport	BL	—	Optional	inside the Parties component
AllocationInstruction	J	Conditional	Optional	inside the Parties component
AllocationInstructionAck	P	Conditional	Optional	inside the Parties component
AllocationInstructionAlert	BM	—	Optional	inside the Parties component
AllocationReport	AS	Conditional	Optional	inside the Parties component
AllocationReportAck	AT	Conditional	Optional	inside the Parties component
ApplicationMessageRequest	BW	—	Optional	inside the Parties component
ApplicationMessageRequestAck	BX	—	Optional	inside the Parties component
AssignmentReport	AW	Conditional	Optional	inside the Parties component
CollateralAssignment	AY	Conditional	Optional	inside the Parties component
CollateralInquiry	BB	Conditional	Optional	inside the Parties component
CollateralInquiryAck	BG	Conditional	Optional	inside the Parties component
CollateralReport	BA	Conditional	Optional	inside the Parties component
CollateralRequest	AX	Conditional	Optional	inside the Parties component
CollateralResponse	AZ	Conditional	Optional	inside the Parties component
Confirmation	AK	Conditional	Optional	inside the Parties component
ContraryIntentionReport	BO	—	Optional	inside the Parties component
CrossOrderCancelReplaceRequest	t	Conditional	Optional	inside SideCrossOrdModGrp › Parties
CrossOrderCancelRequest	u	Conditional	Optional	inside SideCrossOrdCxlGrp › Parties
ExecutionReport	8	Conditional	Optional	inside the Parties component
IOI	6	—	Optional	inside the Parties component
ListCancelRequest	K	—	Optional	inside the Parties component
MarketDataIncrementalRefresh	X	—	Optional	inside MDIncGrp › Parties
MarketDataRequest	V	—	Optional	inside the Parties component
MarketDataRequestReject	Y	—	Optional	inside the Parties component
MarketDataSnapshotFullRefresh	W	—	Optional	inside MDFullGrp › Parties
MassQuote	i	Conditional	Optional	inside the Parties component
MassQuoteAcknowledgement	b	Conditional	Optional	inside the Parties component
MultilegOrderCancelReplace	AC	Conditional	Optional	inside the Parties component
NewOrderCross	s	Conditional	Optional	inside SideCrossOrdModGrp › Parties
NewOrderList	E	Conditional	Optional	inside ListOrdGrp › Parties
NewOrderMultileg	AB	Conditional	Optional	inside the Parties component
NewOrderSingle	D	Conditional	Optional	inside the Parties component
OrderCancelReplaceRequest	G	Conditional	Optional	inside the Parties component
OrderCancelRequest	F	Conditional	Optional	inside the Parties component
OrderMassActionReport	BZ	—	Optional	inside the Parties component
OrderMassActionRequest	CA	—	Optional	inside the Parties component
OrderMassCancelReport	r	—	Optional	inside the Parties component
OrderMassCancelRequest	q	—	Optional	inside the Parties component
OrderMassStatusRequest	AF	Conditional	Optional	inside the Parties component
OrderStatusRequest	H	Conditional	Optional	inside the Parties component
PositionMaintenanceReport	AM	Conditional	Optional	inside the Parties component
PositionMaintenanceRequest	AL	Conditional	Optional	inside the Parties component
PositionReport	AP	Conditional	Optional	inside the Parties component
Quote	S	Conditional	Optional	inside the Parties component
QuoteCancel	Z	Conditional	Optional	inside the Parties component
QuoteRequest	R	Conditional	Optional	inside QuotReqGrp › Parties
QuoteRequestReject	AG	Conditional	Optional	inside QuotReqRjctGrp › Parties
QuoteResponse	AJ	Conditional	Optional	inside the Parties component
QuoteStatusReport	AI	Conditional	Optional	inside the Parties component
QuoteStatusRequest	a	Conditional	Optional	inside the Parties component
RFQRequest	AH	—	Optional	inside the Parties component
RegistrationInstructions	o	Conditional	Optional	inside the Parties component
RegistrationInstructionsResponse	p	Conditional	Optional	inside the Parties component
RequestForPositions	AN	Conditional	Optional	inside the Parties component
RequestForPositionsAck	AO	Conditional	Optional	inside the Parties component
SettlementInstructionRequest	AV	Conditional	Optional	inside the Parties component
SettlementInstructions	T	Conditional	Optional	inside SettlInstGrp › Parties
SettlementObligationReport	BQ	—	Optional	inside SettlObligationInstructions › Parties
StreamAssignmentReport	CD	—	Optional	inside StrmAsgnRptGrp › Parties
StreamAssignmentRequest	CC	—	Optional	inside StrmAsgnReqGrp › Parties
TradeCaptureReport	AE	Conditional	Optional	inside TrdCapRptSideGrp › Parties
TradeCaptureReportAck	AR	—	Optional	inside TrdCapRptAckSideGrp › Parties
TradeCaptureReportRequest	AD	Conditional	Optional	inside the Parties component

Wire format

A single character. Most char fields are enumerated, so the value is one of a fixed set rather than arbitrary text. @boarteam/fix keeps the value as a string and, for enumerated fields, reports validate/value-not-in-enum when it is not a defined value.

Read tag 447 in TypeScript

decode.tsts

import { createFixEngine } from "@boarteam/fix";import { dictionary } from "@boarteam/fix-dict-fix44";const fix = createFixEngine(dictionary);const { message, issues } = fix.parse(raw);const partyIDSource = message.fields[447]?.raw;// e.g. "B" — BIC (Bank Identification Code—Swift managed) code (ISO 9362 - See "Appendix 6-B")// The dictionary also carries the labels:const label = fix.dictionary  .fieldByTag(447)  ?.enumValues?.find((e) => e.value === partyIDSource)  ?.description;

Decode this in your own code

The same engine that produced the decoded example above is an Apache-2.0 npm package with zero runtime dependencies. It runs in Node and in the browser, and parse() returns problems as data instead of throwing.

npm i @boarteam/fix @boarteam/fix-dict-fix44

Try the decoder Source on GitHub