Producer Management API
| Action | Endpoint |
|---|---|
| Fetch Producer | GET/producers/{tenantLocator}/producers/{producerLocator} |
| Fetch Producers | GET/producers/{tenantLocator}/producers/list |
| Fetch Producer Hierarchy | GET/producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy |
| Create Producer | POST/producers/{tenantLocator}/producers |
| Update Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator} |
| Replace Producer | PUT/producers/{tenantLocator}/producers/{producerLocator} |
| Validate Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator}/validate |
| Discard Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator}/discard |
| Suspend Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator}/suspend |
| Unsuspend Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator}/unsuspend |
| Retire Producer | PATCH/producers/{tenantLocator}/producers/{producerLocator}/retire |
| Fetch Producer Code | GET/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} |
| Fetch Producer Codes | GET/producers/{tenantLocator}/producers/{producerLocator}/codes/list |
| Fetch Producer Code By Code | GET/producers/{tenantLocator}/producers/codes/{code} |
| Create Producer Code | POST/producers/{tenantLocator}/producers/{producerLocator}/codes |
| Update Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} |
| Replace Producer Code | PUT/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} |
| Validate Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate |
| Discard Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard |
| Suspend Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend |
| Unsuspend Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend |
| Retire Producer Code | PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire |
| Generate Code By Number | POST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate |
| Set Code By Number | POST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set |
| Fetch Producer License | GET/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} |
| Fetch Producer Licenses | GET/producers/{tenantLocator}/producers/{producerLocator}/licenses/list |
| Create Producer License | POST/producers/{tenantLocator}/producers/{producerLocator}/licenses |
| Update Producer License | PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} |
| Replace Producer License | PUT/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} |
| Validate Producer License | PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate |
| Discard Producer License | PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard |
| Fetch Producer Appointment | GET/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} |
| Fetch Producer Appointments | GET/producers/{tenantLocator}/producers/{producerLocator}/appointments/list |
| Create Producer Appointment | POST/producers/{tenantLocator}/producers/{producerLocator}/appointments |
| Update Producer Appointment | PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} |
| Replace Producer Appointment | PUT/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} |
| Validate Producer Appointment | PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate |
| Discard Producer Appointment | PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard |
Producers
Fetch Producer
fetchProducer/producers/{tenantLocator}/producers/{producerLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducersreadFetch Producers
fetchProducers/producers/{tenantLocator}/producers/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
ListPageResponseProducerResponseproducersread,listFetch Producer Hierarchy
fetchProducerHierarchy/producers/{tenantLocator}/producers/{producerLocator}/producerHierarchyParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerHierarchyResponseproducersreadCreate Producer
createProducer/producers/{tenantLocator}/producersParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes |
Update Producer
updateProducer/producers/{tenantLocator}/producers/{producerLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
Replace Producer
replaceProducer/producers/{tenantLocator}/producers/{producerLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
Validate Producer
validateProducer/producers/{tenantLocator}/producers/{producerLocator}/validateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducerswriteDiscard Producer
discardProducer/producers/{tenantLocator}/producers/{producerLocator}/discardParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducerswriteSuspend Producer
suspendProducer/producers/{tenantLocator}/producers/{producerLocator}/suspendParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducerswriteUnsuspend Producer
unsuspendProducer/producers/{tenantLocator}/producers/{producerLocator}/unsuspendParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducerswriteRetire Producer
retireProducer/producers/{tenantLocator}/producers/{producerLocator}/retireParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerResponseproducerswriteProducer Codes
Fetch Producer Code
fetchProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducersreadFetch Producer Codes
fetchProducerCodes/producers/{tenantLocator}/producers/{producerLocator}/codes/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
ListPageResponseProducerCodeResponseproducersread,listFetch Producer Code By Code
fetchProducerCodeByCode/producers/{tenantLocator}/producers/codes/{code}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
code | path | string | Yes |
ProducerCodeResponseproducersreadCreate Producer Code
createProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codesParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerCodeCreateRequestProducerCodeResponseproducerswriteUpdate Producer Code
updateProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeUpdateRequestProducerCodeResponseproducerswriteReplace Producer Code
replaceProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeReplaceRequestProducerCodeResponseproducerswriteValidate Producer Code
validateProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteDiscard Producer Code
discardProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discardParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteSuspend Producer Code
suspendProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspendParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteUnsuspend Producer Code
unsuspendProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspendParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteRetire Producer Code
retireProducerCode/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retireParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteGenerate Code By Number
generateCodeByNumber/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes |
ProducerCodeResponseproducerswriteSet Code By Number
setCodeByNumber/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/setParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerCodeLocator | path | ulid | Yes | |
code | query | string | Yes |
ProducerCodeResponseproducerswriteLicenses
Fetch Producer License
fetchProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerLicenseLocator | path | ulid | Yes |
ProducerLicenseResponseproducersreadFetch Producer Licenses
fetchProducerLicenses/producers/{tenantLocator}/producers/{producerLocator}/licenses/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
producersread,listCreate Producer License
createProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licensesParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerLicenseCreateRequestProducerLicenseResponseproducerswriteUpdate Producer License
updateProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerLicenseLocator | path | ulid | Yes |
ProducerLicenseUpdateRequestProducerLicenseResponseproducerswriteReplace Producer License
replaceProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerLicenseLocator | path | ulid | Yes |
ProducerLicenseReplaceRequestProducerLicenseResponseproducerswriteValidate Producer License
validateProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerLicenseLocator | path | ulid | Yes |
ProducerLicenseResponseproducerswriteDiscard Producer License
discardProducerLicense/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discardParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerLicenseLocator | path | ulid | Yes |
ProducerLicenseResponseproducerswriteAppointments
Fetch Producer Appointment
fetchProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerAppointmentLocator | path | ulid | Yes |
ProducerAppointmentResponseproducersreadFetch Producer Appointments
fetchProducerAppointments/producers/{tenantLocator}/producers/{producerLocator}/appointments/listParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
offset | query | integer? | No | |
count | query | integer? | No |
producersread,listCreate Producer Appointment
createProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointmentsParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes |
ProducerAppointmentCreateRequestProducerAppointmentResponseproducerswriteUpdate Producer Appointment
updateProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerAppointmentLocator | path | ulid | Yes |
ProducerAppointmentUpdateRequestProducerAppointmentResponseproducerswriteReplace Producer Appointment
replaceProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerAppointmentLocator | path | ulid | Yes |
ProducerAppointmentResponseproducerswriteValidate Producer Appointment
validateProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validateParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerAppointmentLocator | path | ulid | Yes |
ProducerAppointmentResponseproducerswriteDiscard Producer Appointment
discardProducerAppointment/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discardParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
producerLocator | path | ulid | Yes | |
producerAppointmentLocator | path | ulid | Yes |
ProducerAppointmentResponseproducerswriteRequired properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
producerState | Enum draft | validated | suspended | discarded | retired | |
type | string | |
createdAt | datetime | |
createdBy | uuid |
Optional properties
| Property | Type | Description |
|---|---|---|
parentLocator | ulid? | |
validationResult | ValidationResult? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | ProducerResponse[] |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
producerState | Enum draft | validated | suspended | discarded | retired | |
type | string | |
createdAt | datetime | |
createdBy | uuid | |
childProducers | ProducerHierarchyResponse[] |
Optional properties
| Property | Type | Description |
|---|---|---|
parentLocator | ulid? | |
validationResult | ValidationResult? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
type | string |
Optional properties
| Property | Type | Description |
|---|---|---|
parentLocator | ulid? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
removeData | map<string, object> | |
setData | map<string, object> |
Optional properties
| Property | Type | Description |
|---|---|---|
parentLocator | ulid? | |
type | string? |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
producerLocator | ulid | |
producerCodeState | Enum draft | validated | suspended | discarded | retired | |
type | string | |
createdAt | datetime | |
createdBy | uuid |
Optional properties
| Property | Type | Description |
|---|---|---|
code | string? | |
validationResult | ValidationResult? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | ProducerCodeResponse[] |
Required properties
| Property | Type | Description |
|---|---|---|
type | string |
Optional properties
| Property | Type | Description |
|---|---|---|
code | string? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
removeData | map<string, object> | |
setData | map<string, object> |
Optional properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid? | |
code | string? | |
type | string? |
Required properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid | |
type | string |
Optional properties
| Property | Type | Description |
|---|---|---|
code | string? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
producerLocator | ulid | |
producerLicenseState | Enum draft | validated | discarded | |
type | string | |
createdAt | datetime | |
createdBy | uuid | |
jurisdictions | string[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
expirationTime | datetime? | |
licenseNumber | string? | |
validationResult | ValidationResult? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | ProducerLicenseResponse[] |
Required properties
| Property | Type | Description |
|---|---|---|
type | string | |
jurisdictions | string[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
expirationTime | datetime? | |
licenseNumber | string? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
removeData | map<string, object> | |
setData | map<string, object> |
Optional properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid? | |
effectiveTime | datetime? | |
expirationTime | datetime? | |
licenseNumber | string? | |
type | string? | |
jurisdictions | string[]? | |
producerCodes | string[]? | |
products | string[]? |
Required properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid | |
type | string | |
jurisdictions | string[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
expirationTime | datetime? | |
licenseNumber | string? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
producerLocator | ulid | |
producerAppointmentState | Enum draft | validated | discarded | |
type | string | |
createdAt | datetime | |
createdBy | uuid | |
jurisdictions | string[] | |
licenses | ulid[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
appointmentNumber | string? | |
expirationTime | datetime? | |
validationResult | ValidationResult? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
listCompleted | boolean | |
items | ProducerAppointmentResponse[] |
Required properties
| Property | Type | Description |
|---|---|---|
type | string | |
jurisdictions | string[] | |
licenses | ulid[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
appointmentNumber | string? | |
expirationTime | datetime? | |
data | map<string, object>? |
Required properties
| Property | Type | Description |
|---|---|---|
removeData | map<string, object> | |
setData | map<string, object> |
Optional properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid? | |
effectiveTime | datetime? | |
appointmentNumber | string? | |
expirationTime | datetime? | |
type | string? | |
jurisdictions | string[]? | |
licenses | ulid[]? | |
producerCodes | string[]? | |
products | string[]? |
Required properties
| Property | Type | Description |
|---|---|---|
producerLocator | ulid | |
type | string | |
jurisdictions | string[] | |
licenses | ulid[] | |
producerCodes | string[] | |
products | string[] |
Optional properties
| Property | Type | Description |
|---|---|---|
effectiveTime | datetime? | |
appointmentNumber | string? | |
expirationTime | datetime? | |
data | map<string, object>? |