Integration Guides
Customer Journey
- Customer API Overview
- Authentication
API 2.x Reference
- Authorization
- Settings Controller
- IP Controller
- Two-Factor Authentication
- User Access - Password
- Session Controller
- Tenant
- Customers B2X
- Customers B2X API
- Wallet API
- B2C
- Address Management
- B2B / Organization
- GETGet B2B Customer Details
- Organization
- Shareholder V0201
- POSTLog All Events
- GET
- Wallet
- Transfer Order
Update Organization
Update an existing organization
PUT
/
api
/
v2.1
/
organization
/
update
/
{organizationId}
Copy
curl --request PUT \
--url https://sandbox.finhub.cloud/api/v2.1/organization/update/{organizationId} \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: <x-forwarded-for>' \
--data '{
"name": "<string>",
"registrationNumber": "<string>",
"vatNumber": "<string>",
"countryOfIncorporation": "<string>",
"dateOfIncorporation": "2022-03-10T00:00:00.000Z",
"type": "<string>",
"industry": "<string>",
"subIndustry": "<string>",
"size": "<string>",
"website": "<string>"
}'
Copy
{
"success": true,
"message": "<string>",
"data": {
"id": "<string>",
"tenantId": "<string>",
"name": "<string>",
"registrationNumber": "<string>",
"vatNumber": "<string>",
"countryOfIncorporation": "<string>",
"dateOfIncorporation": "2022-03-10T00:00:00.000Z",
"status": "<string>",
"type": "<string>",
"industry": "<string>",
"subIndustry": "<string>",
"size": "<string>",
"website": "<string>",
"addresses": [
{
"id": "<string>",
"addressLine1": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"purpose": "<string>",
"isPrimary": true,
"addressType": "<string>",
"primary": true
}
],
"documents": [
{
"id": "<string>",
"documentType": "<string>",
"documentNumber": "<string>",
"issuingCountry": "<string>",
"issueDate": "2022-03-10T00:00:00.000Z",
"expiryDate": "2022-03-10T00:00:00.000Z",
"purpose": "<string>",
"status": "<string>",
"fileUrl": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"fileSize": "<string>",
"uploadedAt": "2022-03-10T00:00:00.000Z"
}
],
"shareholders": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"role": "<string>",
"ownershipPercentage": 123,
"customerId": "<string>",
"organizationId": "<string>",
"status": "<string>",
"personDetails": {
"id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"dateOfBirth": "2022-03-10T00:00:00.000Z",
"nationality": "<string>",
"countryOfResidence": "<string>",
"email": "<string>",
"phoneNumber": "<string>",
"gender": "<string>",
"addresses": [
{
"id": "<string>",
"addressLine1": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"purpose": "<string>",
"isPrimary": true,
"addressType": "<string>",
"primary": true
}
],
"documents": [
{
"id": "<string>",
"documentType": "<string>",
"documentNumber": "<string>",
"issuingCountry": "<string>",
"issueDate": "2022-03-10T00:00:00.000Z",
"expiryDate": "2022-03-10T00:00:00.000Z",
"purpose": "<string>",
"status": "<string>",
"fileUrl": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"fileSize": "<string>",
"uploadedAt": "2022-03-10T00:00:00.000Z"
}
],
"placeOfBirth": "<string>"
},
"organizationDetails": {}
}
],
"createdAt": "2022-03-10T00:00:00.000Z",
"updatedAt": "2022-03-10T00:00:00.000Z"
}
}
Headers
Forwarded client IP address
Client user agent information
Tenant identifier for multi-tenant operations
Path Parameters
Body
application/json
Response
200 - application/json
OK
The response is of type object
.
Copy
curl --request PUT \
--url https://sandbox.finhub.cloud/api/v2.1/organization/update/{organizationId} \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: <x-forwarded-for>' \
--data '{
"name": "<string>",
"registrationNumber": "<string>",
"vatNumber": "<string>",
"countryOfIncorporation": "<string>",
"dateOfIncorporation": "2022-03-10T00:00:00.000Z",
"type": "<string>",
"industry": "<string>",
"subIndustry": "<string>",
"size": "<string>",
"website": "<string>"
}'
Copy
{
"success": true,
"message": "<string>",
"data": {
"id": "<string>",
"tenantId": "<string>",
"name": "<string>",
"registrationNumber": "<string>",
"vatNumber": "<string>",
"countryOfIncorporation": "<string>",
"dateOfIncorporation": "2022-03-10T00:00:00.000Z",
"status": "<string>",
"type": "<string>",
"industry": "<string>",
"subIndustry": "<string>",
"size": "<string>",
"website": "<string>",
"addresses": [
{
"id": "<string>",
"addressLine1": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"purpose": "<string>",
"isPrimary": true,
"addressType": "<string>",
"primary": true
}
],
"documents": [
{
"id": "<string>",
"documentType": "<string>",
"documentNumber": "<string>",
"issuingCountry": "<string>",
"issueDate": "2022-03-10T00:00:00.000Z",
"expiryDate": "2022-03-10T00:00:00.000Z",
"purpose": "<string>",
"status": "<string>",
"fileUrl": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"fileSize": "<string>",
"uploadedAt": "2022-03-10T00:00:00.000Z"
}
],
"shareholders": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"role": "<string>",
"ownershipPercentage": 123,
"customerId": "<string>",
"organizationId": "<string>",
"status": "<string>",
"personDetails": {
"id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"dateOfBirth": "2022-03-10T00:00:00.000Z",
"nationality": "<string>",
"countryOfResidence": "<string>",
"email": "<string>",
"phoneNumber": "<string>",
"gender": "<string>",
"addresses": [
{
"id": "<string>",
"addressLine1": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"purpose": "<string>",
"isPrimary": true,
"addressType": "<string>",
"primary": true
}
],
"documents": [
{
"id": "<string>",
"documentType": "<string>",
"documentNumber": "<string>",
"issuingCountry": "<string>",
"issueDate": "2022-03-10T00:00:00.000Z",
"expiryDate": "2022-03-10T00:00:00.000Z",
"purpose": "<string>",
"status": "<string>",
"fileUrl": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"fileSize": "<string>",
"uploadedAt": "2022-03-10T00:00:00.000Z"
}
],
"placeOfBirth": "<string>"
},
"organizationDetails": {}
}
],
"createdAt": "2022-03-10T00:00:00.000Z",
"updatedAt": "2022-03-10T00:00:00.000Z"
}
}
Assistant
Responses are generated using AI and may contain mistakes.