Search
K
Trident APIs

Look up contacts by role

Returns XFI contacts filtered by the specified role code. Supports optional free-text filter on contact name/code and page-based pagination.

Common role codes:

Code Role
USR Internal User (Underwriters)
ACC Account / Insured
PRD Producer / Broker
AGR Agreement Partner
OBG Obligor
REIND Reinsured
SCM Syndicate Capital Management
INS Insurer
COV Coverholder
DIV Division
SYN Syndicate
MBK Master Broker

All supported codes: INS, ATT, ACC, PRD, TAX, OTH, CLM, REIN, BCT, USR, EW, IA, EA, CA, AGR, PI, BINS, DIV, SYN, TCC, SRV, COV, LF, AUD, EXUSR, FRC, BA, SA, SOS, OFFTEAM, OBG, LG, RGA, INV, FIN, TAD, ENV, ITA, INA, BEN, ADO, ACF, UWC, BUY, SEL, TGT, PTF, REIND, SCM, PEB, MBK

get
https://trident-api.connecttrident.com/lookup/contacts

Query Parameters

roleCodestringrequired

XFI role code to filter contacts by. See description for full list.

Allowed values:INSATTACCPRDTAXOTHCLMREINBCTUSREWIAEACAAGRPIBINSDIVSYNTCCSRVCOVLFAUDEXUSRFRCBASASOSOFFTEAMOBGLGRGAINVFINTADENVITAINABENADOACFUWCBUYSELTGTPTFREINDSCMPEBMBK

Example:USR

contactReferencestring

Optional partial match on contact name or code (e.g. “Enbridge Inc.”, “MSR”).

Example:Enbridge Inc.

pageinteger

Page number, 1-based. Defaults to 1.

Default:1

>= 1

Example:1

pageSizeinteger

Number of results per page. Defaults to 25. Maximum 100.

Default:25

>= 1<= 100

Example:25

Response

application/json

Contacts retrieved successfully

ContactLookupResponse

Paginated response returned by the /lookup/contacts endpoint.

totalintegerrequired

Total number of matching contacts in XFI (may exceed the count on this page).

pageintegerrequired

Current page number (1-based).

pageSizeintegerrequired

Number of items per page.

itemsarray[object]required

A single contact entry returned by the /lookup/contacts endpoint.

Show Child Parameters
get/lookup/contacts
 
application/json

Agreement

object

Agreement information

agreementstringrequired

Agreement code e.g., ‘AGR0000159’

agreementActivitystringrequired

Agreement activity code e.g., ‘AGR0000159-22-01’

agreementSectionstringrequired

Agreement section code e.g., ‘1’

solvencyIIClassstringrequired

Solvency II class code e.g., ‘ZX’

aggregateLimitnumberrequired

Aggregate limit amount e.g., ‘1000’

gELRnumber(double)required

gELR amount at section level e.g., ‘50’

100%Limitnumberrequired

100% Limit amount e.g., ‘1000’

Example

CodeSplit

object

Code split information

percentagenumber

Percentage value

riskCodestring

Risk code

regulatoryCodestringrequired

regulatory Code

codeSplitPcnumber(double)required

codeSplitPc value

gELRnumber(double)required

gELR amount

Example

Coverage

object

Coverage information

premiumnumberrequired

Premium amount e.g., ‘15000’

coveragestring

coverage description e.g., ‘50’

limitOccurrenceinteger(int32)required

limitOccurrence e.g., ‘100’

limitAggregateinteger(int32)required

limitAggregate e.g., ‘100’

deductibleinteger(int32)
100%Limitnumberrequired

100% Limit amount e.g., ‘500000’

ratedPremium(100%)integer(int32)required

ratedPremium100 e.g., ‘15000’

Example

Deduction

object

Deduction information

deductionTypestring

Deduction type code

deductionstringrequired

Deduction code e.g., ‘BK’

deductionBasisstring

Deduction basis code

deductionRatenumber(double)required

Deduction Rate e.g., ‘20’

rate%number

Rate percentage

Example