Skip to main content
GET
cURL
Returns all agents associated with your upstream entity. You can filter results by downstream entity association, NPN, license number, or email address.
The npn, licenseNumber/stateCode, and email filters are mutually exclusive. Use one of them, not several. The email filter matches the agent primary email or any labeled email (business, personal, or other) and is case-insensitive.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

downstreamEntityAssociationId
string

Filter by downstream entity association ID

npn
string

Filter by National Producer Number (NPN). Mutually exclusive with licenseNumber/stateCode and email.

Example:

"123456"

licenseNumber
string

Filter by license number. Must be provided together with stateCode. Mutually exclusive with npn and email.

Example:

"ABC123456"

stateCode
string

Filter by state code. Must be provided together with licenseNumber. Mutually exclusive with npn and email.

Example:

"AK"

email
string

Exact email address to filter agents by. Matches the agent primary email or any labeled email (business/personal/other), case-insensitively. Mutually exclusive with npn and licenseNumber/stateCode.

Example:

"agent@example.com"

Response

List of agents

data
object[]
required
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"