Register business profile
The Register business profile section is designed to streamline the process for businesses to get started on our platform. Users can easily create and manage their business profiles and access essential features to kickstart their operations.
Use Cases
- You want to onboard a business user who is a business or corporate entity, not a natural person.
- You want to onboard a business user who will use an account for business purposes.
- You want to onboard a business user who is a sub-entity (sub-account) of the main program partner.
- You want to onboard a business user who is a corporate client (sub-account) of the main program partner.
- You want to onboard a business user who is a corporate client sub-entity (client sub-account) of your corporate client (sub-account).
- You want to onboard a business user (child) who is associated with another business (parent).
Prerequisites
- Before starting to collect business user information from your customers, refer to the User Protection Guidelines, which all platform consumers and partners must follow and adhere to with regard to securing customer data.
- Collect business information from the corporate customer. This activity must be accomplished before calling the first API in the onboarding workflow. Information can be collected in-app from the partner's mobile or web application.
Business User data
The data that needs to be collected from the business can be broken down into these groups:
- Business profile and legal identifiers - Vital identity information is required to create a user in the system. These will include legal business names, representative contacts, and other relevant details.
- Business demographics details - Additional statistics, foundation, and operational addresses of the business entity.
API Workflow (v2)
1
Create a business user profile in the program
You can start registering a business profile when the business profile and legal identifiers are ready.
Create Business User (Parent)
Call Create Business User (POST /businesses) to create a business profile for the corporate entity that you are onboarding.
Business user registration
Create Business User (Parent) - Providing minimum required information
Create Business User (Parent) - Providing minimum required information
Minimum required business information
Collecting minimum information from the business during the initial contact will reduce onboarding friction and increase user acquisition. By segmenting the business onboarding, we can also reduce the form fields being built on the frontend to collect business information. Instead, we can then just allow the business to provide all the required information and documents during the eKYC information collection screens. For businesses, the minimum required business information is the following:
preferred_namecompany_nameemailmobile_country_codemobile
Create Business User (Parent) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/businesses' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"preferred_name": "Corp ABC",
"company_name": "Corporate ABC",
"email": "abc@corporateabc.com",
"mobile_country_code": "65",
"mobile": "99919997"
}'Create Business User (Parent) response
JSON
{
"id": "be9db48068c4455782067426fdccd90b",
"type": "business",
"client_ref_id": "9234567",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate ABC",
"email": "admin@corporateabc.com",
"mobile_country_code": "65",
"mobile": "99999991",
"business_id": "",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Directors Registry",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "Debt",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending_activation",
"sub_status": "document_verification_required",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T12:15:44Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate ABC",
"foundation_date": "2021-01-02",
"role": "Platform User",
"alternative_names": [
"ABC"
],
"lei_code": "ncmxn1c1",
"website": "www.corporateabc.com",
"supporting_documents": [
{
"id_number": "M41wewewe1",
"id_type": "Proof of Nature of Business",
"id_sub_type": "abc",
"id_issuance_country": "Denmark",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": true,
"is_expiry_extended": true
}
]
}Create Business User (Parent) - Providing complete user information
Create Business User (Parent) - Providing complete user information
Region-specific Onboarding
The example below displays the exhaustive set of user information fields that can be passed through the Create Business User endpoint. However, since this endpoint is utilized for multiple regions with different regulatory requirements, usage per region will differ. Partners are encouraged to refer to the Region-specific Onboarding section to see the list of business information required for their program region. Only the listed region-specific business information is required to be collected from the users and submitted for business registration.
Create Business User (Parent) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/businesses' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"client_ref_id": "9234567",
"provider_action_id": "1g172h21j19",
"preferred_name": "Corporate ABC",
"company_name": "Corporate ABC",
"role": "PLATFORM_USER",
"lei_code": "ncmxn1c1",
"website": "www.corporateabc.com",
"alternative_names": [
"ABC"
],
"email": "admin@corporateabc.com",
"mobile_country_code": "65",
"mobile": "99999991",
"foundation_date": "2021-01-02",
"supporting_documents": [
{
"id_number": "M41wewewe1",
"id_type": "PROOF_OF_NATURE_OF_BUSINESS",
"id_issuance_country": "DNK",
"id_sub_type": "abc",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": true,
"is_expiry_extended": true
}
],
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "DIRECTORS_REGISTRY",
"id_date_added": "2019-08-24",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "AFG"
}
},
"addresses": {
"foundation": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"line_3": "",
"line_4": "",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"country": "PHL",
"postal_code": "2200"
},
"operational": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"country": "PHL",
"postal_code": "4107"
}
},
"socioprofessional_category": "string",
"purpose_of_account_opening": "CASH_DEPOSIT",
"self_declared_as_pep": true,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"provider_ref_id": "",
"provider_account_number": "",
"posting_status": "ok",
"source_of_funds": "DEBT",
"data_terms_signed_at": "2022-06-15 00:00:00",
"created_by": "bot@matchmove.com"}
}'Create Business User (Parent) response
JSON
{
"id": "be9db48068c4455782067426fdccd90b",
"type": "business",
"client_ref_id": "9234567",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate ABC",
"email": "admin@corporateabc.com",
"mobile_country_code": "65",
"mobile": "99999991",
"business_id": "",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Directors Registry",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "101",
"line_2": "Kitcheners Rd",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "Debt",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending_activation",
"sub_status": "document_verification_required",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T12:15:44Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate ABC",
"foundation_date": "2021-01-02",
"role": "Platform User",
"alternative_names": [
"ABC"
],
"lei_code": "ncmxn1c1",
"website": "www.corporateabc.com",
"supporting_documents": [
{
"id_number": "M41wewewe1",
"id_type": "Proof of Nature of Business",
"id_sub_type": "abc",
"id_issuance_country": "Denmark",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": true,
"is_expiry_extended": true
}
]
}Business Hierarchical Structure
Businesses often organize themselves into layers, where smaller branches or subsidiaries are distinct entities but still belong to the main parent company. Individual employees, on the other hand, are organized directly under their departments or employers. Financial flows follow this same path, where the parent company allocates capital downward for operations, and the revenue generated by these employees flows back up through their branch to the main entity.
MatchMove Banking API is designed to cater to various business structure nuances. You should be able to create parent-child relationships and maintain hierarchical structures with individual and business entities. e.g.,
- Business A (Parent) is associated to Business B (Child)
- Business A (Parent) is associated to Individual User A (Child)
Create (Sub-business) Business User
Call Create (Sub-business) Business User (POST /businesses/{{parent_business_id}}/businesses) to create a business profile and associate it with a parent business.
(Sub-business) Business User registration
Create (Sub-business) Business User - Providing minimum required information
Create (Sub-business) Business User - Providing minimum required information
Minimum required sub-business information - Business
Collecting minimum information from the business during the initial contact will reduce onboarding friction and increase user acquisition. By segmenting the business onboarding, we can also reduce the form fields being built on the frontend to collect business information. Instead, we can then just allow the business to provide all the required information and documents during the eKYC information collection screens. For businesses, the minimum required business information is the following:
preferred_namecompany_nameemailmobile_country_codemobile
Create (Sub-business) Business User request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/businesses/{{business_parent_id}}/businesses' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"preferred_name": "Corp XYZ",
"company_name": "Corporate XYZ",
"email": "xyz@corporatxyz.com",
"mobile_country_code": "65",
"mobile": "89919997"
}'Create (Sub-business) Business User response
JSON
{
"id": "a8a911536dd84504a0bd86efe99f1618",
"type": "business",
"client_ref_id": "",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corp XYZ",
"email": "xyz@corporatxyz.com",
"mobile_country_code": "65",
"mobile": "89919997",
"business_id": "9fcc5c86a79f4bf18ab69f435ca66b10",
"identification": {
"primary": {},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {},
"operational": {}
},
"data_terms_signed_at": "",
"source_of_funds": "",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending_activation",
"sub_status": "additional_info_required",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-05-05T11:11:45Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate XYZ",
"role": "End User"
}Create (Sub-business) Business User - Providing complete user information
Create (Sub-business) Business User - Providing complete user information
Region-specific Onboarding
The example below displays the exhaustive set of user information fields that can be passed through the Create Business User endpoint. However, since this endpoint is utilized for multiple regions with different regulatory requirements, usage per region will differ. Partners are encouraged to refer to the Region-specific Onboarding section to see the list of business information required for their program region. Only the listed region-specific business information is required to be collected from the users and submitted for business registration.
Create (Sub-business) Business User request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/businesses/{{parent_business_id}}/businesses' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"client_ref_id": "7234567891",
"provider_action_id": "99111777b",
"preferred_name": "Corporate XYZ",
"type": "business",
"role": "SUB_PARTNER_USER",
"company_name": "Corporate XYZ",
"lei_code": "1ncmxnc11",
"website": "www.corporatexyz.com",
"foundation_date" : "2023-08-01",
"alternative_names": [
"XYZ"
],
"email": "admin@corporatexyz.com",
"mobile_country_code": "65",
"mobile": "88811111",
"supporting_documents": [
{
"id_number": "M414L711",
"id_type": "PROOF_OF_ADDRESS",
"id_issuance_country": "PHL",
"id_sub_type": "abc",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": false,
"is_expiry_extended": false
}
],
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "GOOD_STANDING_CERT",
"id_date_added": "2019-08-24",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "AFG"
}
},
"addresses": {
"foundation": {
"line_1": "111",
"line_2": "Sunshine St",
"line_3": "",
"line_4": "",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"country": "PHL",
"postal_code": "2200"
},
"operational": {
"line_1": "111",
"line_2": "Sunshine St",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"country": "PHL",
"postal_code": "4107"
}
},
"socioprofessional_category": "string",
"purpose_of_account_opening": "CASH_DEPOSIT",
"self_declared_as_pep": true,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"provider_ref_id": "",
"provider_account_number": "",
"posting_status": "ok",
"source_of_funds": "DEBT",
"data_terms_signed_at": "2022-06-15 00:00:00",
"metadata": {
"test_identifier": "aaabbbb"
},
"created_by": "bot@matchmove.com"
}'Create (Sub-business) Business User response
JSON
{
"id": "c19db9f95a5e4d56bbc27a1ddb5e9fd8",
"type": "business",
"client_ref_id": "7234567891",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate XYZ",
"email": "admin@corporatexyz.com",
"mobile_country_code": "65",
"mobile": "88811111",
"business_id": "be9db48068c4455782067426fdccd90b",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Good Standing Certificate",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "111",
"line_2": "Sunshine St",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "111",
"line_2": "Sunshine St",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "Debt",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending_activation",
"sub_status": "document_verification_required",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T12:25:44Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate XYZ",
"foundation_date": "2023-08-01",
"role": "Sub Partner User",
"alternative_names": [
"XYZ"
],
"lei_code": "1ncmxnc11",
"website": "www.corporatexyz.com",
"supporting_documents": [
{
"id_number": "M414L711",
"id_type": "Proof of Address",
"id_sub_type": "abc",
"id_issuance_country": "Philippines",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN"
}
]
}Business user identifier as a partner foreign key When a new business user is created, a user identifier (user.id) will be generated.
In the example above, the user identifier will be the "id": "121a84f24763990b12a6c55e2993ac4a".
It is recommended that you store this MatchMove user identifier in your internal database and map it with your users.
This business user identifier will be heavily used in most post-user creation APIs, and it will be convenient for you to have it accessible.
2
[Optional] Define business-associated parties
Customer due diligence on a business requires verification of the business and its associated parties, such as its shareholders, directors, and beneficial owners.
During the eKYC process, all the declared associated parties in the business profile will also be sent their own eKYC verification links for completion.
The business eKYC approval will be blocked unless all the connected parties have also completed and passed their own verification.
Thus, it is important to declare all business-associated parties prior to initiating the business eKYC process.
*This step is optional because the definition of associated parties can primarily be done through the eKYC capture screens.
Create Business-Associated Parties API-required fields enumerations:
roleallowed values are listed in the Associated Party Roles Enumeration (GET /users/enumerations/associated_party_roles).
| Shareholder | Individual, Business |
| Investor | Individual, Business |
| Legal Advisor | Individual, Business |
| Trustee | Individual, Business |
| Trust beneficiary | Individual, Business |
| Trust settlor | Individual, Business |
| Trust protector | Individual, Business |
| Director | Individual, Business |
| Secretary | Individual, Business |
| Founder | Individual, Business |
| Ultimate Beneficial Owner | Individual |
| Authorized Representative | Individual |
| Authorized signatory | Individual |
| Company officer (CEO, CFO, etc.) | Individual |
Create Business-Associated Parties
Call Create Business-Associated Parties (POST /associated_parties) to define an associated party with the business profile. An associated party can be either an individual or a business.
This is an OPTIONAL activity for Business User registration. Since onboarding businesses can define their associated parties from the eKYC information collection screens.
Business-Associated Parties registration
Create Business-Associated Parties (Individual) - Providing minimum required information
Create Business-Associated Parties (Individual) - Providing minimum required information
Minimum required associated party information - Individual
For individual associated parties, the minimum required individuals information is the following:
first_namelast_nameroletypeemailmobile_country_codemobile
Create Business-Associated Parties (Individual) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"email": "jane.smith@matchmove.com",
"mobile_country_code": "65",
"mobile": "91759691",
"type": "individual",
"role": "DIRECTOR",
"first_name": "Jane",
"last_name": "Smith"
}'Create Business-Associated Parties (Individual) response
JSON
{
"id": "216ca49a839b475ca323dc9d01edfe7b",
"type": "individual",
"client_ref_id": "",
"provider_ref_id": "",
"provider_account_number": "",
"salutation": "",
"suffix": "",
"title": "",
"first_name": "Jane",
"middle_name": "",
"last_name": "Smith",
"preferred_name": "",
"email": "jane.smith@matchmove.com",
"mobile_country_code": "65",
"mobile": "91759691",
"gender": "",
"marital_status": "",
"identification": {
"primary": {},
"secondary": {}
},
"birth": {},
"nationality": "",
"mothers_details": {},
"father_details": {},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {},
"operational": {}
},
"employment_type": "",
"job_title": "",
"employment_details": {
"business_trading_name": "",
"business_purpose": "",
"industry": "",
"industry_key": "",
"own_economic_interest_signed_at": "",
"expected_monthly_revenue": "",
"vat_number": "",
"business_address": {}
},
"fatca_crs_confirmed_at": "0001-01-01T00:00:00Z",
"fatca_relevant": false,
"data_terms_signed_at": "",
"annual_income_range": "",
"main_income_source": "",
"purpose_of_account_opening": "",
"socioprofessional_category": "",
"work_country": "",
"residency_country": "",
"self_declared_as_pep": false,
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "pending",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-05-05T15:02:25Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"role": "Appointed to manage the company business and affairs",
"business_id": "a8a911536dd84504a0bd86efe99f1618"
}Create Business-Associated Parties (Individual) - Providing complete user information
Create Business-Associated Parties (Individual) - Providing complete user information
Create Business-Associated Parties (Individual) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"client_ref_id": "9234567891",
"type": "individual",
"preferred_name": "Owen Owner",
"salutation": "mr",
"role": "UBO",
"title": "dr",
"first_name": "Owen",
"middle_name": "V",
"last_name": "Owner",
"maiden_name": "",
"marital_status": "SINGLE",
"email": "owen.owner@matchmove.com",
"mobile_country_code": "65",
"mobile": "88296601",
"supporting_documents": [
{
"id_number": "M41wewewe1",
"id_type": "UTILITY_BILL",
"id_issuance_country": "DNK",
"id_sub_type": "abc",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": true,
"is_expiry_extended": true
}
],
"identification": {
"primary": {
"id_number": "M4WMB6RLH1218",
"id_type": "id_card",
"id_date_added": "2019-08-24",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "AFG"
},
"secondary": {
"id_number": "seconds719218",
"id_type": "drivers_id",
"id_date_added": "2019-08-24",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "AFG"
}
},
"birth": {
"name": "Owen Owner",
"date": "2000-04-02",
"city": "Gen Trias",
"country": "PHL",
"postal_code": "1000"
},
"nationality": "AFGHAN",
"mothers_details": {
"first_name": "Est",
"middle_name": "Tori",
"last_name": "Mir",
"maiden_name": "e t m"
},
"fathers_details": {
"first_name": "Vir",
"middle_name": "Cab",
"last_name": "Mir",
"maiden_name": "v c m"
},
"addresses": {
"residential": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"line_3": "",
"line_4": "",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"country": "AFG",
"postal_code": "2200"
},
"billing": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"country": "AFG",
"postal_code": "4107"
},
"shipping": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"country": "AFG",
"state": "Cavite",
"postal_code": "4107"
}
},
"employment_type": "SELF-EMPLOYED",
"job_title": "ACCOUNTANT",
"employment_details": {
"business_purpose": "ACCOUNTING",
"business_trading_name": "abcdefg",
"industry": "Finance & Tech",
"industry_key": "fintech",
"own_economic_interest_signed_at": "Manila",
"expected_monthly_revenue": "1000000",
"vat_number": "893678372",
"business_address": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"country": "AFG",
"state": "Cavite",
"postal_code": "4107"
}
},
"fatca_crs_confirmed_at": "2019-08-24T14:15:22Z",
"fatca_relevant": true,
"annual_income_range": "20000",
"main_income_source": "SALARY",
"socioprofessional_category": "string",
"purpose_of_account_opening": "string",
"work_country": "Philippines",
"residency_country": "Philippines",
"self_declared_as_pep": true,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"provider_ref_id": "",
"provider_account_number": "",
"posting_status": "ok",
"data_terms_signed_at": "2022-06-15 00:00:00",
"metadata": {
"internal_identifier": "123232dd"
},
"created_by": "bot@matchmove.com"
}'Create Business-Associated Parties (Individual) response
JSON
{
"id": "7f93a313eb1b454e9f63483831e879da",
"type": "business",
"client_ref_id": "",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "",
"email": "admin@corpdef.com",
"mobile_country_code": "65",
"mobile": "917198943",
"business_id": "a8a911536dd84504a0bd86efe99f1618",
"identification": {
"primary": {},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {},
"operational": {}
},
"data_terms_signed_at": "",
"source_of_funds": "",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "pending",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-05-05T15:11:08Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corp DEF",
"role": "Entitled to benefit from assets held in a trust"
}
Create Business-Associated Parties (Business) - Providing minimum required information
Create Business-Associated Parties (Business) - Providing minimum required information
Minimum required associated party information - Business
For business-associated parties, the minimum required business information is the following:
typecompany_nameemailmobile_country_codemobilerole
Create Business-Associated Parties (Business) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Sms0Qm5QOG1LRWpabDkzOVVybkM1d242MlQybFE2RVY6Q2o2d21VRTJyUnBGUTh1TmhvOGtKZmFhSUxadTA2TGRzcFBrb3RhVHJGVjNEU2FBYWhzZ2RHUzBTSXRpdVNJQQ==' \
--data-raw '{
"email": "admin@corpdef.com",
"mobile_country_code": "65",
"mobile": "917198943",
"company_name": "Corp DEF",
"type": "business",
"role": "TRUSTBENEFICIARY"
}'Create Business-Associated Parties (Business) response
JSON
{
"id": "4812461a30924c5c91f983970af3caea",
"type": "business",
"client_ref_id": "9234567891",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate DEF",
"email": "admin@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898989",
"business_id": "8824d28441cb4486ac9c875aa1d3bc69",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Good Standing Certificate",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "pending",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T13:04:43Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate DEF",
"foundation_date": "2023-08-01",
"role": "ultimate beneficial owner of the company",
"alternative_names": [
"DEF"
],
"lei_code": "da122231",
"website": "www.corporatedef.com",
"supporting_documents": [
{
"id_number": "M414L711",
"id_type": "PROOF_OF_ADDRESS",
"id_sub_type": "abc",
"id_issuance_country": "PHL",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN"
}
]
}Create Business-Associated Parties (Business) - Providing complete user information
Create Business-Associated Parties (Business) - Providing complete user information
CrCreate Business-Associated Parties (Business) request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data-raw '{
"client_ref_id": "9234567891",
"provider_action_id": "1221355",
"preferred_name": "Corporate DEF",
"type": "business",
"role": "UBO",
"company_name": "Corporate DEF",
"lei_code": "da122231",
"website": "www.corporatedef.com",
"foundation_date" : "2023-08-01",
"alternative_names": [
"DEF"
],
"email": "admin@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898989",
"supporting_documents": [
{
"id_number": "M414L711",
"id_type": "PROOF_OF_ADDRESS",
"id_issuance_country": "PHL",
"id_sub_type": "abc",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN",
"is_term_unlimited": false,
"is_expiry_extended": false
}
],
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "GOOD_STANDING_CERT",
"id_date_added": "2019-08-24",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "AFG"
}
},
"addresses": {
"foundation": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"line_3": "",
"line_4": "",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"country": "PHL",
"postal_code": "2200"
},
"operational": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"line_3": "",
"line_4": "",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"country": "PHL",
"postal_code": "4107"
}
},
"socioprofessional_category": "string",
"purpose_of_account_opening": "CASH_DEPOSIT",
"self_declared_as_pep": true,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"provider_ref_id": "",
"provider_account_number": "",
"posting_status": "ok",
"source_of_funds": "DEBT",
"data_terms_signed_at": "2022-06-15 00:00:00",
"metadata": {
"internal_identifier": "aaa121bbb"
},
"created_by": "bot@matchmove.com"
}'Create Business-Associated Parties (Business) response
JSON
{
"id": "4812461a30924c5c91f983970af3caea",
"type": "business",
"client_ref_id": "9234567891",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate DEF",
"email": "admin@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898989",
"business_id": "8824d28441cb4486ac9c875aa1d3bc69",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Good Standing Certificate",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "pending",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T13:04:43Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate DEF",
"foundation_date": "2023-08-01",
"role": "ultimate beneficial owner of the company",
"alternative_names": [
"DEF"
],
"lei_code": "da122231",
"website": "www.corporatedef.com",
"supporting_documents": [
{
"id_number": "M414L711",
"id_type": "PROOF_OF_ADDRESS",
"id_sub_type": "abc",
"id_issuance_country": "PHL",
"id_issuer_name": "passport authority",
"id_issuer_code": "PA",
"id_issuer_state": "TN"
}
]
}Get Business-Associated Parties
Call Get Business-Associated Parties (GET /associated_parties) to retrieve a list of all the associated parties connected to a business.
Get Business-Associated Parties request
CURL
curl --location 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••'Get Business-Associated Parties response
JSON
{
"pagination": {
"total_records": 2,
"records_per_page": 10,
"total_pages": 1,
"links": {
"self": "https://svc-customer.uat.matchmove-beta.com/api/v2/associated_parties?page=1&records_per_page=10",
"next": "",
"previous": ""
}
},
"data": [
{
"id": "4812461a30924c5c91f983970af3caea",
"type": "business",
"client_ref_id": "9234567891",
"provider_ref_id": "",
"provider_account_number": "",
"preferred_name": "Corporate DEF",
"email": "admin@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898989",
"business_id": "8824d28441cb4486ac9c875aa1d3bc69",
"identification": {
"primary": {
"id_number": "M1417112",
"id_type": "Good Standing Certificate",
"id_date_issued": "2025-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {}
},
"addresses": {
"residential": {},
"billing": {},
"shipping": {},
"identity_verification": {},
"foundation": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"state_code": "1234",
"postal_code": "2200",
"country": "Philippines"
},
"operational": {
"line_1": "881",
"line_2": "Wimbledon Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Philippines"
}
},
"data_terms_signed_at": "",
"source_of_funds": "",
"purpose_of_account_opening": "",
"tos_acceptance": {
"date": "0001-01-01T00:00:00Z",
"ip": "",
"service_agreement": "",
"user_agent": "",
"device_id": ""
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T13:04:43Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"company_name": "Corporate DEF",
"foundation_date": "2023-08-01",
"role": "ultimate beneficial owner of the company",
"alternative_names": [
"DEF"
],
"lei_code": "da122231",
"website": "www.corporatedef.com",
"supporting_documents": [
{
"id_number": "PROOF_OF_ADDRESS",
"id_type": "M414L711",
"id_sub_type": "abc",
"id_issuance_country": "PHL",
"id_issuer_code": "PA"
}
]
},
{
"id": "eed3d63039e94e9ea92aeaa568c73b02",
"type": "individual",
"client_ref_id": "9234567891",
"provider_ref_id": "",
"provider_account_number": "",
"salutation": "mr",
"title": "DR",
"first_name": "Owen",
"middle_name": "V",
"last_name": "Owner",
"preferred_name": "Owen Owner",
"email": "owen.owner@matchmove.com",
"mobile_country_code": "65",
"mobile": "88296601",
"gender": "",
"marital_status": "SINGLE",
"identification": {
"primary": {
"id_number": "M4WMB6RLH1218",
"id_type": "Id Card",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {
"id_number": "seconds719218",
"id_type": "Driver's license",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
}
},
"birth": {
"name": "Owen Owner",
"date": "2000-04-02",
"city": "Gen Trias",
"country": "Philippines",
"postal_code": "1000"
},
"nationality": "AFGHAN",
"mothers_details": {
"first_name": "Est",
"middle_name": "Tori",
"last_name": "Mir",
"maiden_name": "e t m"
},
"father_details": {
"first_name": "Vir",
"middle_name": "Cab",
"last_name": "Mir",
"maiden_name": "v c m"
},
"addresses": {
"residential": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"postal_code": "2200",
"country": "Afghanistan"
},
"billing": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Afghanistan"
},
"shipping": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Afghanistan"
},
"identity_verification": {},
"foundation": {},
"operational": {}
},
"employment_type": "SELF-EMPLOYED",
"job_title": "ACCOUNTANT",
"employment_details": {
"business_trading_name": "abcdefg",
"business_purpose": "ACCOUNTING",
"industry": "Finance & Tech",
"industry_key": "fintech",
"own_economic_interest_signed_at": "Manila",
"expected_monthly_revenue": "1000000",
"vat_number": "893678372",
"business_address": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"postal_code": "4107",
"city": "ABORLAN_PALAWAN",
"country": "Afghanistan",
"state": "Cavite"
}
},
"fatca_crs_confirmed_at": "0001-01-01T00:00:00Z",
"fatca_relevant": false,
"data_terms_signed_at": "",
"annual_income_range": "20000",
"main_income_source": "SALARY",
"purpose_of_account_opening": "",
"socioprofessional_category": "",
"work_country": "Philippines",
"residency_country": "Philippines",
"self_declared_as_pep": false,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T12:54:19Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"role": "ultimate beneficial owner of the company",
"business_id": "8824d28441cb4486ac9c875aa1d3bc69",
"supporting_documents": [
{
"id_number": "UTILITY_BILL",
"id_type": "M41wewewe1",
"id_sub_type": "abc",
"id_issuance_country": "DNK",
"id_issuer_code": "PA",
"is_term_unlimited": true,
"is_expiry_extended": true
}
]
}
]
}Update Business-Associated Party
Call Update Business-Associated Party (PUT /associated_parties/{{associated_party_id}}) update the details of an associated party.
Update Business-Associated Party (Individual) request
CURL
curl --location --request PUT 'https://{{identity_base_url}}/{{program_code}}/v2/associated_parties/{{associated_party_id}}' \
--header 'X-Auth-User-ID: {{parent_business_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••'' \
--data-raw '{
"type": "individual",
"email": "new@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898981"
}'Updated Business-Associated Party (Individual) response
JSON
{
"id": "eed3d63039e94e9ea92aeaa568c73b02",
"type": "individual",
"client_ref_id": "9234567891",
"provider_ref_id": "",
"provider_account_number": "",
"salutation": "mr",
"title": "DR",
"first_name": "Owen",
"middle_name": "V",
"last_name": "Owner",
"preferred_name": "Owen Owner",
"email": "new@corporatedef.com",
"mobile_country_code": "65",
"mobile": "89898981",
"gender": "",
"marital_status": "SINGLE",
"identification": {
"primary": {
"id_number": "M4WMB6RLH1218",
"id_type": "Id Card",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
},
"secondary": {
"id_number": "seconds719218",
"id_type": "Driver's license",
"id_date_issued": "2020-06-08",
"id_date_expiry": "2028-08-24",
"id_issuance_country": "Afghanistan"
}
},
"birth": {
"name": "Owen Owner",
"date": "2000-04-02",
"city": "Gen Trias",
"country": "Philippines",
"postal_code": "1000"
},
"nationality": "AFGHAN",
"mothers_details": {
"first_name": "Est",
"middle_name": "Tori",
"last_name": "Mir",
"maiden_name": "e t m"
},
"father_details": {
"first_name": "Vir",
"middle_name": "Cab",
"last_name": "Mir",
"maiden_name": "v c m"
},
"addresses": {
"residential": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "GABALDON_BITULOK_SAB",
"state": "LAUNION",
"postal_code": "2200",
"country": "Afghanistan"
},
"billing": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Afghanistan"
},
"shipping": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"city": "ABORLAN_PALAWAN",
"state": "Cavite",
"postal_code": "4107",
"country": "Afghanistan"
},
"identity_verification": {},
"foundation": {},
"operational": {}
},
"employment_type": "SELF-EMPLOYED",
"job_title": "ACCOUNTANT",
"employment_details": {
"business_trading_name": "abcdefg",
"business_purpose": "ACCOUNTING",
"industry": "Finance & Tech",
"industry_key": "fintech",
"own_economic_interest_signed_at": "Manila",
"expected_monthly_revenue": "1000000",
"vat_number": "893678372",
"business_address": {
"line_1": "999",
"line_2": "Jackfruit Dr",
"postal_code": "4107",
"city": "ABORLAN_PALAWAN",
"country": "Afghanistan",
"state": "Cavite"
}
},
"fatca_crs_confirmed_at": "0001-01-01T00:00:00Z",
"fatca_relevant": false,
"data_terms_signed_at": "",
"annual_income_range": "20000",
"main_income_source": "SALARY",
"purpose_of_account_opening": "",
"socioprofessional_category": "",
"work_country": "Philippines",
"residency_country": "Philippines",
"self_declared_as_pep": false,
"tos_acceptance": {
"date": "2019-08-24T14:15:22Z",
"ip": "192.168.0.1",
"service_agreement": "terms_condition",
"user_agent": "Curl",
"device_id": "SteveOS-High"
},
"metadata": null,
"agent_id": "",
"partner_id": "",
"customer_id": "",
"status": "pending",
"sub_status": "",
"kyc_status": "not_submitted",
"kyc_sub_status": "",
"transaction_status": "",
"transaction_sub_status": "",
"is_email_verified": "1",
"is_mobile_verified": "1",
"is_risk_flagged": "UNKNOWN",
"kyc_processed_date": "",
"date_created": "2026-02-11T12:54:19Z",
"date_updated": "0001-01-01T00:00:00Z",
"pending_update": [],
"verification_id": {},
"require_provider_update": [],
"http_status_code": 0,
"requirements": {
"immediately_due": {
"required_attributes": [],
"required_actions": []
},
"eventually_due": {
"required_attributes": [],
"required_actions": []
},
"pending_verification": {}
},
"risk_assesment_status": "UNKNOWN",
"status_reason_code": "",
"status_message": "",
"role": "ultimate beneficial owner of the company",
"business_id": "8824d28441cb4486ac9c875aa1d3bc69"
}Related Links
Was this section helpful?
On this page
- Register business profile