Socotra
API Reference

Producer Management API

ActionEndpoint
Fetch ProducerGET/producers/{tenantLocator}/producers/{producerLocator}
Fetch ProducersGET/producers/{tenantLocator}/producers/list
Fetch Producer HierarchyGET/producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy
Create ProducerPOST/producers/{tenantLocator}/producers
Update ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}
Replace ProducerPUT/producers/{tenantLocator}/producers/{producerLocator}
Validate ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}/validate
Discard ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}/discard
Suspend ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}/suspend
Unsuspend ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}/unsuspend
Retire ProducerPATCH/producers/{tenantLocator}/producers/{producerLocator}/retire
Fetch Producer CodeGET/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}
Fetch Producer CodesGET/producers/{tenantLocator}/producers/{producerLocator}/codes/list
Fetch Producer Code By CodeGET/producers/{tenantLocator}/producers/codes/{code}
Create Producer CodePOST/producers/{tenantLocator}/producers/{producerLocator}/codes
Update Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}
Replace Producer CodePUT/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}
Validate Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate
Discard Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard
Suspend Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend
Unsuspend Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend
Retire Producer CodePATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire
Generate Code By NumberPOST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate
Set Code By NumberPOST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set
Fetch Producer LicenseGET/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}
Fetch Producer LicensesGET/producers/{tenantLocator}/producers/{producerLocator}/licenses/list
Create Producer LicensePOST/producers/{tenantLocator}/producers/{producerLocator}/licenses
Update Producer LicensePATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}
Replace Producer LicensePUT/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}
Validate Producer LicensePATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate
Discard Producer LicensePATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard
Fetch Producer AppointmentGET/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}
Fetch Producer AppointmentsGET/producers/{tenantLocator}/producers/{producerLocator}/appointments/list
Create Producer AppointmentPOST/producers/{tenantLocator}/producers/{producerLocator}/appointments
Update Producer AppointmentPATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}
Replace Producer AppointmentPUT/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}
Validate Producer AppointmentPATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate
Discard Producer AppointmentPATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard

Producers

Fetch Producer

Fetch ProducerfetchProducer
GET/producers/{tenantLocator}/producers/{producerLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
read

Fetch Producers

Fetch ProducersfetchProducers
GET/producers/{tenantLocator}/producers/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:producers
Permissions:
read,list

Fetch Producer Hierarchy

Fetch Producer HierarchyfetchProducerHierarchy
GET/producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
read

Create Producer

Create ProducercreateProducer
POST/producers/{tenantLocator}/producers

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Security Group:producers
Permission:
write

Update Producer

Update ProducerupdateProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Replace Producer

Replace ProducerreplaceProducer
PUT/producers/{tenantLocator}/producers/{producerLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Validate Producer

Validate ProducervalidateProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Discard Producer

Discard ProducerdiscardProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Suspend Producer

Suspend ProducersuspendProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}/suspend

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Unsuspend Producer

Unsuspend ProducerunsuspendProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}/unsuspend

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Retire Producer

Retire ProducerretireProducer
PATCH/producers/{tenantLocator}/producers/{producerLocator}/retire

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Producer Codes

Fetch Producer Code

Fetch Producer CodefetchProducerCode
GET/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
read

Fetch Producer Codes

Fetch Producer CodesfetchProducerCodes
GET/producers/{tenantLocator}/producers/{producerLocator}/codes/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:producers
Permissions:
read,list

Fetch Producer Code By Code

Fetch Producer Code By CodefetchProducerCodeByCode
GET/producers/{tenantLocator}/producers/codes/{code}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
codepathstringYes
Security Group:producers
Permission:
read

Create Producer Code

Create Producer CodecreateProducerCode
POST/producers/{tenantLocator}/producers/{producerLocator}/codes

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Update Producer Code

Update Producer CodeupdateProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Replace Producer Code

Replace Producer CodereplaceProducerCode
PUT/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Validate Producer Code

Validate Producer CodevalidateProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Discard Producer Code

Discard Producer CodediscardProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Suspend Producer Code

Suspend Producer CodesuspendProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Unsuspend Producer Code

Unsuspend Producer CodeunsuspendProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Retire Producer Code

Retire Producer CoderetireProducerCode
PATCH/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Generate Code By Number

Generate Code By NumbergenerateCodeByNumber
POST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
Security Group:producers
Permission:
write

Set Code By Number

Set Code By NumbersetCodeByNumber
POST/producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerCodeLocatorpathulidYes
codequerystringYes
Security Group:producers
Permission:
write

Licenses

Fetch Producer License

Fetch Producer LicensefetchProducerLicense
GET/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerLicenseLocatorpathulidYes
Security Group:producers
Permission:
read

Fetch Producer Licenses

Fetch Producer LicensesfetchProducerLicenses
GET/producers/{tenantLocator}/producers/{producerLocator}/licenses/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:producers
Permissions:
read,list

Create Producer License

Create Producer LicensecreateProducerLicense
POST/producers/{tenantLocator}/producers/{producerLocator}/licenses

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Update Producer License

Update Producer LicenseupdateProducerLicense
PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerLicenseLocatorpathulidYes
Security Group:producers
Permission:
write

Replace Producer License

Replace Producer LicensereplaceProducerLicense
PUT/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerLicenseLocatorpathulidYes
Security Group:producers
Permission:
write

Validate Producer License

Validate Producer LicensevalidateProducerLicense
PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerLicenseLocatorpathulidYes
Security Group:producers
Permission:
write

Discard Producer License

Discard Producer LicensediscardProducerLicense
PATCH/producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerLicenseLocatorpathulidYes
Security Group:producers
Permission:
write

Appointments

Fetch Producer Appointment

Fetch Producer AppointmentfetchProducerAppointment
GET/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerAppointmentLocatorpathulidYes
Security Group:producers
Permission:
read

Fetch Producer Appointments

Fetch Producer AppointmentsfetchProducerAppointments
GET/producers/{tenantLocator}/producers/{producerLocator}/appointments/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:producers
Permissions:
read,list

Create Producer Appointment

Create Producer AppointmentcreateProducerAppointment
POST/producers/{tenantLocator}/producers/{producerLocator}/appointments

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
Security Group:producers
Permission:
write

Update Producer Appointment

Update Producer AppointmentupdateProducerAppointment
PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerAppointmentLocatorpathulidYes
Security Group:producers
Permission:
write

Replace Producer Appointment

Replace Producer AppointmentreplaceProducerAppointment
PUT/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerAppointmentLocatorpathulidYes
Security Group:producers
Permission:
write

Validate Producer Appointment

Validate Producer AppointmentvalidateProducerAppointment
PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerAppointmentLocatorpathulidYes
Security Group:producers
Permission:
write

Discard Producer Appointment

Discard Producer AppointmentdiscardProducerAppointment
PATCH/producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
producerLocatorpathulidYes
producerAppointmentLocatorpathulidYes
Security Group:producers
Permission:
write
ProducerResponse

Required properties

PropertyTypeDescription
locatorulid
producerStateEnum draft | validated | suspended | discarded | retired
typestring
createdAtdatetime
createdByuuid

Optional properties

PropertyTypeDescription
parentLocatorulid?
validationResultValidationResult?
datamap<string, object>?
ListPageResponseProducerResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsProducerResponse[]
ProducerHierarchyResponse

Required properties

PropertyTypeDescription
locatorulid
producerStateEnum draft | validated | suspended | discarded | retired
typestring
createdAtdatetime
createdByuuid
childProducersProducerHierarchyResponse[]

Optional properties

PropertyTypeDescription
parentLocatorulid?
validationResultValidationResult?
datamap<string, object>?
ProducerCreateRequest

Required properties

PropertyTypeDescription
typestring

Optional properties

PropertyTypeDescription
parentLocatorulid?
datamap<string, object>?
ProducerUpdateRequest

Required properties

PropertyTypeDescription
removeDatamap<string, object>
setDatamap<string, object>

Optional properties

PropertyTypeDescription
parentLocatorulid?
typestring?
ProducerCodeResponse

Required properties

PropertyTypeDescription
locatorulid
producerLocatorulid
producerCodeStateEnum draft | validated | suspended | discarded | retired
typestring
createdAtdatetime
createdByuuid

Optional properties

PropertyTypeDescription
codestring?
validationResultValidationResult?
datamap<string, object>?
ListPageResponseProducerCodeResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsProducerCodeResponse[]
ProducerCodeCreateRequest

Required properties

PropertyTypeDescription
typestring

Optional properties

PropertyTypeDescription
codestring?
datamap<string, object>?
ProducerCodeUpdateRequest

Required properties

PropertyTypeDescription
removeDatamap<string, object>
setDatamap<string, object>

Optional properties

PropertyTypeDescription
producerLocatorulid?
codestring?
typestring?
ProducerCodeReplaceRequest

Required properties

PropertyTypeDescription
producerLocatorulid
typestring

Optional properties

PropertyTypeDescription
codestring?
datamap<string, object>?
ProducerLicenseResponse

Required properties

PropertyTypeDescription
locatorulid
producerLocatorulid
producerLicenseStateEnum draft | validated | discarded
typestring
createdAtdatetime
createdByuuid
jurisdictionsstring[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
expirationTimedatetime?
licenseNumberstring?
validationResultValidationResult?
datamap<string, object>?
ListPageResponseProducerLicenseResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsProducerLicenseResponse[]
ProducerLicenseCreateRequest

Required properties

PropertyTypeDescription
typestring
jurisdictionsstring[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
expirationTimedatetime?
licenseNumberstring?
datamap<string, object>?
ProducerLicenseUpdateRequest

Required properties

PropertyTypeDescription
removeDatamap<string, object>
setDatamap<string, object>

Optional properties

PropertyTypeDescription
producerLocatorulid?
effectiveTimedatetime?
expirationTimedatetime?
licenseNumberstring?
typestring?
jurisdictionsstring[]?
producerCodesstring[]?
productsstring[]?
ProducerLicenseReplaceRequest

Required properties

PropertyTypeDescription
producerLocatorulid
typestring
jurisdictionsstring[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
expirationTimedatetime?
licenseNumberstring?
datamap<string, object>?
ProducerAppointmentResponse

Required properties

PropertyTypeDescription
locatorulid
producerLocatorulid
producerAppointmentStateEnum draft | validated | discarded
typestring
createdAtdatetime
createdByuuid
jurisdictionsstring[]
licensesulid[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
appointmentNumberstring?
expirationTimedatetime?
validationResultValidationResult?
datamap<string, object>?
ListPageResponseProducerAppointmentResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsProducerAppointmentResponse[]
ProducerAppointmentCreateRequest

Required properties

PropertyTypeDescription
typestring
jurisdictionsstring[]
licensesulid[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
appointmentNumberstring?
expirationTimedatetime?
datamap<string, object>?
ProducerAppointmentUpdateRequest

Required properties

PropertyTypeDescription
removeDatamap<string, object>
setDatamap<string, object>

Optional properties

PropertyTypeDescription
producerLocatorulid?
effectiveTimedatetime?
appointmentNumberstring?
expirationTimedatetime?
typestring?
jurisdictionsstring[]?
licensesulid[]?
producerCodesstring[]?
productsstring[]?
ProducerAppointmentReplaceRequest

Required properties

PropertyTypeDescription
producerLocatorulid
typestring
jurisdictionsstring[]
licensesulid[]
producerCodesstring[]
productsstring[]

Optional properties

PropertyTypeDescription
effectiveTimedatetime?
appointmentNumberstring?
expirationTimedatetime?
datamap<string, object>?

On this page