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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Fin

Fin Customers API

Customer management and document upload operations

Documentation Provider Profile APIs.io OpenAPI GitHub

Fin Customers API is one of 9 APIs that Fin publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 20 operations across 18 paths, and defines 47 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://sandbox.api.fin.com, https://api.fin.com.

20 operations 18 paths 47 schemas 6 GET1 PATCH13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.fin.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Fin Customers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth).

  • bearerAuth — Bearer token authentication. Obtain token from [Issue a Token](https://developer.fin.com/api-reference/authentication/issue-a-token) endpoint

Paths & Operations 20

Across 18 paths, the API surfaces 20 operations — 6 GET, 1 PATCH, 13 POST. Each is listed below with its method, path, parameters, and response codes.

Customers 20

Customer management and document upload operations

GET
/v2/customers
List Customers V2
3 params → 200401422
GET
/v1/customers
List Customers
3 params → 200401422
GET
/v2/customers/{customer_id}
Get Customer Details V2
1 param → 200401404422
GET
/v1/customers/{customer_id}
Get Customer Details
1 param → 200401404422
PATCH
/v1/customers/{customer_id}
Update Customer
1 param body → 200400401404422
POST
/v2/customers/{customer_id}/wallets
Create Customer Wallets
1 param body → 200401409422
GET
/v2/customers/{customer_id}/wallets
Get Customer Wallets
1 param → 200401404
GET
/v2/customers/{customer_id}/capabilities
Get Customer Capabilities
1 param → 200401404422
POST
/v2/customers/individual
Create Individual Customer V2
body → 200401422423
POST
/v1/customers/individual
Create Individual Customer
body → 200401422423
POST
/v2/customers/business
Create Business Customer V2
body → 201400401423500
POST
/v1/customers/business
Create Business Customer
body → 200401422423
POST
/v1/customers/upload
Upload Document
body → 200401422
POST
/v2/customers/{customer_id}/individual/attach
Attach Documents to Individual Customer V2
1 param body → 200400401403404409422500
POST
/v1/customers/individual/attach
Attach Documents to Individual Customer
body → 200401422
POST
/v1/customers/associated-parties/individual/attach
Attach Document To Associated Party
body → 200401422
POST
/v1/customers/business/attach
Attach Documents to Business Customer
body → 200401422
POST
/v1/customers/enable-preference
Enable USD Features
body → 200401422
POST
/v2/customers/{customer_id}/business/attach
Attach Documents to Business Customer V2
1 param body → 200400401404422
POST
/v2/customers/{customer_id}/associated-parties/individual/attach
Attach Documents to Associated Party V2
1 param body → 200400401404422

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are V2AML (19 properties), BusinessCustomerDetail (16 properties), IndividualCustomerDetail (16 properties), V2BasicInfo (15 properties). Each schema is shown below with its type and property counts.

V2Addresses
object
3 properties 2 required
CreateIndividualCustomerInput
object
5 properties 4 required
V2Compliance
object
5 properties
V2RiskProfile
object
5 properties
AttachDocumentForIndividualCustomerInput
object
4 properties 4 required
CustomerWallet
object
6 properties
V2AddressDocumentAttachment
object
2 properties 2 required
V2IndividualAddressDocument
object
4 properties 3 required
V2FinancialProfile
object
11 properties 7 required
V2BasicInfo
object
15 properties 12 required
BusinessCustomerDetail
object
16 properties
V2AssociatedPartySupportingDocumentAttachment
object
2 properties 2 required
V2IndividualAttachIdentifyingDocument
object
7 properties 2 required
CreateBusinessCustomerInput
object
6 properties 4 required
V2RegulatedActivity
object
4 properties 4 required
V2AssociatedParty
object
5 properties 3 required
V2FormationDocumentItem
object
3 properties 1 required
CreateBusinessCustomerV2Input
object
10 properties 6 required
V2IndividualIdentifyingDocument
object
3 properties 3 required
ProofOfAddressIndividual
object
The proof of address document must not be older than three months.
3 properties 3 required
CreateIndividualCustomerV2Input
object
5 properties 4 required
V2Address
object
9 properties 7 required
AttachDocumentsToBusinessCustomerV2Input
object
4 properties 1 required
IndividualCustomerDetail
object
16 properties
V2AML
object
19 properties
AttachDocumentsToAssociatedPartyV2Input
object
1 property 1 required
V2AssociatedPartyAttachment
object
4 properties 1 required
V2IdentifyingDocument
object
3 properties 3 required
V2HoldingStructure
object
3 properties
AttachDocumentsToIndividualCustomerV2Input
object
3 properties 3 required
V2CorporateShareholder
object
7 properties 4 required
V2CustomerRiskSplit
object
Breakdown of customer risk classifications. Percentages must sum to 100.
3 properties 3 required
AttachDocumentsToBusinessCustomerInput
object
5 properties 5 required
V2OwnershipInfo
object
Required when roles includes ubo.
6 properties 6 required
BusinessCustomerDetailV2
object
14 properties
V2VerificationMethod
object
Used for customeridentityverification, pepandsanctionsscreening, and transactionmonitoring.
2 properties 2 required
ProofOfIdentity
object
6 properties 6 required
V2SupportingDocumentItem
object
3 properties 1 required
V2PublicListing
object
3 properties
CountryCode
string
ISO 3166-1 alpha-3 country code
IndividualCustomerDetailV2
object
15 properties
AttachDocumentToAssociatedPartyInput
object
2 properties 2 required
V2OwnershipDocumentItem
object
3 properties 1 required
V2ForeignBranch
object
3 properties 1 required
V2IdentifyingDocumentAttachment
object
6 properties 6 required
ProofOfAddressBusiness
object
3 properties 3 required
V2APBasicInfo
object
13 properties 10 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

fin-customers-api-openapi.yml Raw ↑

Other APIs Fin publishes across the network.

Fin Authentication API
AE Profile APIs.io
Fin Balances API
AE Profile APIs.io
Fin Beneficiaries API
AE Profile APIs.io
Fin Catalogue API
AE Profile APIs.io
Fin Crypto Orchestration API
AE Profile APIs.io
Fin Fees & FX Rates API
AE Profile APIs.io
Fin Transactions API
AE Profile APIs.io
Fin Virtual Accounts API
AE Profile APIs.io
#Customers
← Back to F APIs
API Details
ID
fin:fin-customers-api
Base URL
https://api.fin.com
Docs
https://developer.fin.com/
Provider
Fin
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=fin-customers-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/fin-customers-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Fin Customers 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.