Get Brokerage

Returns a single brokerage by ID.

Required permission: company.brokerage:read

GET /api/external/companies/{companyId}/brokerages/{brokerageId}

Get Brokerage

cURL

curl --request GET \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/brokerages/{brokerageId} \
  --header 'Authorization: <api-key>'

200

success

{ "id": "550e8400-e29b-41d4-a716-446655440001", "name": "Acme Insurance Agency", "commissionPaymentMethod": "agencyBill", "niprBrokerageNumber": "12345678", "email": "[e-mail]", "addressStructured": { "line1": "123 Main Street", "line2": "Suite 100", "city": "New York", "state": "NY", "zip": "10001", "country": "US" }, "phone": "[phone]", "defaultCommissionPercentage": 15, "createdAt": "2025-01-15T10:30:00.000Z", "updatedAt": "2025-01-16T14:20:00.000Z" }

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

brokerageId · string<uuid> · required

Brokerage identifier

Response

200

application/json

Brokerage details

A brokerage (insurance agency or broker) in the system

id · string<uuid>

Brokerage identifier

name · string

Brokerage name

commissionPaymentMethod · enum<string>

Method for handling commission payments

Available options: agencyBill, directBill, doNotHandle

niprBrokerageNumber · string | null

NIPR brokerage number

email · string<email> | null

Brokerage email address

addressStructured · object

Structured address information

Show child attributes

phone · string | null

Phone number

defaultCommissionPercentage · number | null

Default commission percentage for this brokerage

createdAt · string<date-time> | null

When the brokerage was created (ISO 8601)

updatedAt · string<date-time> | null

When the brokerage was last updated (ISO 8601)