Socotra

Socotra Producers API

The Producers API from Socotra — 31 operation(s) for producers.

GitHub OpenAPI
Business capability
Insurance Distribution Management BC-2110

Operations 39

GET /producers/{tenantLocator}/producers/{producerLocator} Fetch producer #
PUT /producers/{tenantLocator}/producers/{producerLocator} Replace producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator} Update producer #
GET /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} Fetch producer license #
PUT /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} Replace producer license #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} Update producer license #
GET /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} Fetch producer code #
PUT /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} Replace producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} Update producer code #
GET /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} Fetch producer appointment #
PUT /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} Replace producer appointment #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} Update producer appointment #
POST /producers/{tenantLocator}/producers Create producer #
POST /producers/{tenantLocator}/producers/{producerLocator}/licenses Create producer license #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes Create producer code #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set Set code by number #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate Generate code by number #
POST /producers/{tenantLocator}/producers/{producerLocator}/appointments Create producer appointment #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/validate Validate producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/unsuspend Unsuspend producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/suspend Suspend producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/retire Retire producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate Validate producer license #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard Discard producer license #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/discard Discard producer #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate Validate producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend Unsuspend producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend Suspend producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire Retire producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard Discard producer code #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate Validate producer appointment #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard Discard producer appointment #
GET /producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy Fetch producer hierarchy #
GET /producers/{tenantLocator}/producers/{producerLocator}/licenses/list Fetch producer licenses #
GET /producers/{tenantLocator}/producers/{producerLocator}/codes/list Fetch producer codes #
GET /producers/{tenantLocator}/producers/{producerLocator}/appointments/list Fetch producer appointments #
GET /producers/{tenantLocator}/producers/list Fetch producers #
GET /producers/{tenantLocator}/producers/codes/{code} Fetch producer code by code #
GET /producers/events Fetch producers event definitions #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-producers-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/socotra-producers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

socotra-producers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Socotra Insurance Suite OpenAPI Definition Producers API
  description: Socotra Insurance Suite API
  termsOfService: https://www.socotra.com
  version: v0
servers:
- url: /
  description: Generated server url
tags:


# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-producers-api-openapi.yml