How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Fintary AMS API

Agency Management System REST API covering the policy, customer and agent record core — policy detail, status changes, teams, tasks, commission breakdown and the two-phase document repository upload; customer CRUD, summaries and bulk update; agent CRUD, contracts, hierarchy and full upline/downline tree; task management and escalation; custom-field and status configuration; and a page-config/capabilities registry that publishes bindable fields, widget vocabulary and an endpoint allowlist for AI and wire clients. Sixty operations under `/api/ams/` on api.fintary.com, authenticated with an HTTP bearer token.

This API exposes 60 operations across 43 paths, organized into 6 resource areas, and defines 112 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against the base URL https://api.fintary.com.

60 operations 43 paths 112 schemas 6 DELETE28 GET12 PATCH12 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://api.fintary.com
Authentication
HTTP Bearer
Resource Areas
6

Authentication & Security 1

Fintary AMS API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (string) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 60

Across 43 paths, the API surfaces 60 operations — 6 DELETE, 28 GET, 12 PATCH, 12 POST, 2 PUT. They span 6 resource areas: AMS - Agents, AMS - Configs, AMS - Customers, AMS - Policies, AMS - Registry, AMS - Tasks. Each is listed below with its method, path, parameters, and response codes.

AMS - Agents 14

Agent management endpoints

GET
/api/ams/agents/{strId}
Agent detail
1 param → 200404
PATCH
/api/ams/agents/{strId}
Update an agent
1 param body → 200404
DELETE
/api/ams/agents/{strId}
Delete an agent
1 param → 200404
GET
/api/ams/agents/{strId}/contracts/{contractId}
Contract detail
2 params → 200404
PATCH
/api/ams/agents/{strId}/contracts/{contractId}
Update a contract
2 params body → 200404
DELETE
/api/ams/agents/{strId}/contracts/{contractId}
Delete a contract
2 params → 200404
GET
/api/ams/agents/{strId}/contracts
List agent contracts
1 param → 200404
POST
/api/ams/agents/{strId}/contracts
Create agent contract
1 param body → 200404
GET
/api/ams/agents/{strId}/hierarchy
Get agent hierarchy tree (uplines and downlines)
1 param → 200404
GET
/api/ams/agents/{strId}/tree
Get the full hierarchy tree for an agent (ancestors + descendants)
2 params → 200404
PATCH
/api/ams/agents/bulk-update
Bulk update agents
body → 200
GET
/api/ams/agents
List agents
1 param → 200
POST
/api/ams/agents
Create an agent
body → 200
GET
/api/ams/agents/summary
Agent summary
→ 200
AMS - Configs 3

AMS configuration endpoints (statuses, roles)

GET
/api/ams/configs/custom-fields
List custom field definitions for the current account
1 param → 200
POST
/api/ams/configs/custom-fields
Create a custom field definition
body → 200
GET
/api/ams/configs/statuses
List status configurations
1 param → 200
AMS - Customers 8

Customer management endpoints

GET
/api/ams/customers/{strId}
Customer detail
1 param → 200404
PATCH
/api/ams/customers/{strId}
Update a customer
1 param body → 200404
DELETE
/api/ams/customers/{strId}
Delete a customer
1 param → 200404
GET
/api/ams/customers/{strId}/policies
List policies for a customer
1 param → 200
PATCH
/api/ams/customers/bulk-update
Bulk update customers
body → 200
GET
/api/ams/customers
List customers
1 param → 200
POST
/api/ams/customers
Create a customer
body → 200
GET
/api/ams/customers/summary
Customer summary
→ 200
AMS - Policies 24

Policy management endpoints

PATCH
/api/ams/policies/{strId}/case-manager
Update policy case manager
1 param body → 200
GET
/api/ams/policies/{strId}/commission
Get policy commission info (receivables, payouts by role, statement totals)
1 param → 200404
GET
/api/ams/policies/{strId}/customers
List customers associated with a policy
1 param → 200404
DELETE
/api/ams/policies/{strId}/documents/{documentStrId}
Delete policy document
2 params → 200404
GET
/api/ams/policies/{strId}/documents/{documentStrId}/download
Short-lived signed download URL for a policy document
2 params → 200404
POST
/api/ams/policies/{strId}/documents/finalize
Finalize a policy document upload (phase 2 of two)
1 param body → 200404
GET
/api/ams/policies/{strId}/documents
List policy documents (Document Repository Service)
1 param → 200404
POST
/api/ams/policies/{strId}/documents
Start a policy document upload (phase 1 of two)
1 param body → 201404
GET
/api/ams/policies/{strId}
Policy detail
1 param → 200404
PATCH
/api/ams/policies/{strId}
Update policy
1 param body → 200404
DELETE
/api/ams/policies/{strId}
Delete policy
1 param → 200404
PATCH
/api/ams/policies/{strId}/status
Change policy status
1 param body → 200404
PATCH
/api/ams/policies/{strId}/tasks/{taskId}
Update policy task
2 params body → 200404
DELETE
/api/ams/policies/{strId}/tasks/{taskId}
Delete policy task
2 params → 200404
GET
/api/ams/policies/{strId}/tasks
List policy tasks
1 param → 200404
POST
/api/ams/policies/{strId}/tasks
Create policy task
1 param body → 200404
GET
/api/ams/policies/{strId}/team
Get policy team
1 param → 200404
PATCH
/api/ams/policies/{strId}/team
Update policy team
1 param body → 200404
PATCH
/api/ams/policies/bulk-update
Bulk update policies
body → 200
POST
/api/ams/policies/filter-options
Get filter option values for the policy list
body → 200
GET
/api/ams/policies/filters
Get policy list filter metadata
→ 200
POST
/api/ams/policies
Create a policy
body → 200
POST
/api/ams/policies/list
List policies with basic info
body → 200
GET
/api/ams/policies/summary
Policy summary grouped by status
→ 200
AMS - Registry 5
GET
/api/ams/registry/capabilities
Get the AI/wire manifest (bindable fields, widget vocabulary, endpoint allowlist, limits) for an AMS entity
1 param → 200304
PUT
/api/ams/registry/page-config-default
Make one of the calling account's saved page-config variants its active default
1 param body → 200
PUT
/api/ams/registry/page-config-save
Save a named page-config variant for the calling account
1 param body → 200
GET
/api/ams/registry/page-config
Get the wire page config for an AMS entity
1 param → 200304
GET
/api/ams/registry/page-configs
List the calling account's saved page-config variants for an AMS entity (excludes the account's active default)
1 param → 200
AMS - Tasks 6
PATCH
/api/ams/tasks/{taskId}
Update a task
1 param body → 200404
POST
/api/ams/tasks/{taskId}/escalate
Escalate a task
1 param body → 200404
GET
/api/ams/tasks
List the current user's tasks
1 param → 200
POST
/api/ams/tasks
Create a task
body → 201
GET
/api/ams/tasks/scope
Get the current user's agent scope (self + downline contacts)
→ 200
GET
/api/ams/tasks/summary
Get a summary of the current user's tasks
1 param → 200

Schemas 112

The contract defines 112 schemas that model the data the API accepts and returns. The most detailed are PolicyDetailResponseSchema (57 properties), PolicyListItemSchema (51 properties), AgentDetailResponseSchema (42 properties), AmsUpdatePolicySchema (41 properties). Each schema is shown below with its type and property counts.

AgentDetailResponseSchema
object
42 properties 41 required
AgentHierarchyNodeSchema
object
10 properties 10 required
AgentHierarchyResponseSchema
object
9 properties 9 required
AgentListItemSchema
object
36 properties 36 required
AgentListResponseSchema
object
2 properties 2 required
AgentSummaryResponseSchema
object
4 properties 4 required
AgentTreeNodeSchema
object
11 properties 3 required
AgentTreeResponseSchema
object
3 properties 2 required
AmsAgentContractPathParamsSchema
object
2 properties 2 required
AmsAgentListQuerySchema
object
12 properties 3 required
AmsAgentPathParamsSchema
object
1 property 1 required
AmsAgentTreeQuerySchema
object
2 properties 1 required
AmsBindableFieldSchema
object
1 property 1 required
AmsBulkUpdateAgentDataSchema
object
13 properties
AmsBulkUpdateAgentsBodySchema
object
2 properties 2 required
AmsBulkUpdateCustomerDataSchema
object
13 properties
AmsBulkUpdateCustomersBodySchema
object
2 properties 2 required
AmsBulkUpdatePoliciesBodySchema
object
2 properties 2 required
AmsBulkUpdatePolicyDataSchema
object
15 properties
AmsBulkUpdateResponseSchema
object
1 property 1 required
AmsCapabilitiesResponseSchema
object
6 properties 6 required
AmsContractListQuerySchema
object
6 properties
AmsContractStatusSchema
string
AmsCreateAgentSchema
object
16 properties
AmsCreateContractSchema
object
7 properties 1 required
AmsCreateCustomFieldDefinitionSchema
object
12 properties 9 required
AmsCreateCustomerSchema
object
15 properties
AmsCreateMyTaskSchema
object
9 properties 6 required
AmsCreatePolicyDocumentSchema
object
5 properties 3 required
AmsCreatePolicySchema
object
41 properties
AmsCreatePolicyTaskSchema
object
6 properties 4 required
AmsCustomFieldDefinitionSchema
object
14 properties 13 required
AmsCustomFieldListQuerySchema
object
1 property
AmsCustomFieldValueInputSchema
object
6 properties 1 required
AmsCustomFieldValueSchema
object
9 properties 4 required
AmsCustomerAddressSchema
object
10 properties
AmsCustomerListQuerySchema
object
9 properties 3 required
AmsCustomerPathParamsSchema
object
1 property 1 required
AmsCustomerPoliciesQuerySchema
object
4 properties 3 required
AmsEscalateMyTaskSchema
object
4 properties 2 required
AmsFilterConditionSchema
object
3 properties 2 required
AmsFilterFieldSchema
object
8 properties 5 required
AmsFilterNodeSchema
AmsFilterValueSchema
AmsFinalizePolicyDocumentSchema
object
3 properties 1 required
AmsLimitsSchema
object
4 properties 4 required
AmsMyTasksQuerySchema
object
6 properties 2 required
AmsMyTasksSummaryQuerySchema
object
1 property
AmsPageConfigResponseSchema
object
5 properties 5 required
AmsPageConfigWireSchema
object
10 properties 8 required
AmsPaginationSchema
object
4 properties 4 required
AmsPolicyDocumentPathParamsSchema
object
2 properties 2 required
AmsPolicyDocumentStatusSchema
string
AmsPolicyFilterMetadataSchema
object
1 property 1 required
AmsPolicyFilterOptionsQuerySchema
object
5 properties 3 required
AmsPolicyListQuerySchema
object
5 properties 3 required
AmsPolicyPathParamsSchema
object
1 property 1 required
AmsPolicyTaskPathParamsSchema
object
2 properties 2 required
AmsPolicyTeamMemberSchema
object
5 properties 3 required
AmsRegistryEntitySchema
string
AmsRegistryErrorSchema
object
2 properties 2 required
AmsSortSchema
object
2 properties 2 required
AmsStatusConfigItemSchema
object
8 properties 8 required
AmsStatusConfigListQuerySchema
object
1 property
AmsUpdateAgentSchema
object
16 properties
AmsUpdateContractSchema
object
6 properties
AmsUpdateCustomerSchema
object
15 properties
AmsUpdateMyTaskSchema
object
7 properties 1 required
AmsUpdatePolicyCaseManagerSchema
object
1 property 1 required
AmsUpdatePolicyDocumentSchema
object
2 properties
AmsUpdatePolicySchema
object
41 properties
AmsUpdatePolicyStatusSchema
object
1 property 1 required
AmsUpdatePolicyTaskSchema
object
6 properties
AmsUpdatePolicyTeamSchema
object
1 property 1 required
AmsWidgetVocabularySchema
object
4 properties 4 required
ContractCompanyResponseSchema
object
7 properties 7 required
ContractListResponseSchema
object
4 properties 4 required
ContractResponseSchema
object
13 properties 11 required
CustomerDetailResponseSchema
object
34 properties 33 required
CustomerListItemSchema
object
29 properties 28 required
CustomerListResponseSchema
object
2 properties 2 required
CustomerSummaryResponseSchema
object
5 properties 5 required
MyAgentScopeResponseSchema
object
4 properties 3 required
MyTaskContactSchema
object
4 properties 1 required
MyTaskItemSchema
object
15 properties 9 required
MyTaskListResponseSchema
object
2 properties 2 required
MyTaskPolicyContextSchema
object
6 properties 1 required
MyTasksSummaryResponseSchema
object
2 properties 2 required
PolicyCaseManagerUpdateResponseSchema
object
2 properties 1 required
PolicyCommissionDetailSchema
object
7 properties 7 required
PolicyCommissionPayoutByRoleSchema
object
3 properties 3 required
PolicyCommissionReceivableLineSchema
object
8 properties 8 required
PolicyCustomerListItemSchema
object
8 properties 2 required
PolicyDetailResponseSchema
object
57 properties 57 required
PolicyDocumentDetailSchema
object
11 properties 5 required
PolicyDocumentUploadTicketSchema
object
3 properties 3 required
PolicyFilterOptionFieldSchema
object
3 properties 3 required
PolicyFilterOptionValueSchema
object
3 properties 3 required
PolicyFilterOptionsResponseSchema
object
3 properties 3 required
PolicyListItemSchema
object
51 properties 51 required
PolicyListResponseSchema
object
2 properties 2 required
PolicySummaryResponseSchema
object
2 properties 2 required
PolicyTaskDetailSchema
object
9 properties 9 required
PolicyTeamMemberContactSchema
object
8 properties 8 required
PolicyTeamMemberDetailSchema
object
7 properties 7 required
AmsWireDataSourceConfigSchema
object
7 properties 3 required
AmsWireSummaryConfigSchema
object
3 properties
AmsWireTableConfigSchema
object
4 properties 2 required
AmsWireColumnConfigSchema
object
8 properties 2 required
AmsWireFilterConfigSchema
AmsWireTabConfigSchema
object
5 properties 3 required
AmsWireBlockConfigSchema
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

fintary-ams-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Fintary AMS API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.