- Getting started
- Authentication
- Webhooks
- Embeddable Widgets
- Guides
- API Reference
- Submissions
- Documents
- RPC Search
- Utilities
- Submissions
Get submission
Production
https://api.niva.co/v1
Production
https://api.niva.co/v1
GET
https://api.niva.co/v1
Request
Authorization
Add parameter in header
apiKey
Example:
apiKey: ********************Path Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.niva.co/v1/submissions/' \
--header 'apiKey: <api-key>'Responses
🟢200Success
application/json
Bodyapplication/json
Example
{
"id": "c6b31844d0b6ccce4cd68c84",
"status": "needs_review",
"country": "MX",
"inputs": {
"business_type": "sole_proprietor",
"legal_name": "Acme Inc.",
"trade_name": "Acme",
"rfc": "NVA120490XD2",
"website": "http://rusty-propaganda.eus",
"operating_address": "Lado Pablo s/n., 22439 Murcia, Mad",
"applicant": {
"first_name": "Joaquín",
"email": "Ariadna_Pedroza93@hotmail.com",
"phone": "980404451",
"last_name": "Yáñez"
}
},
"documents": [
{
"id": "e310f2bab81d273b7339e5d8",
"status": "valid",
"document_type": "mx_acta_constitutiva",
"data": {},
"validation_errors": [
{
"error": "blank",
"error_message": "Document is blank"
}
],
"uploaded_at": "2024-07-21T13:35:30.561Z"
},
{
"id": "215faeb7dc2ddf0d0bcceead",
"status": "valid",
"document_type": "mx_acta_asamblea",
"data": {},
"validation_errors": [
{
"error": "incomplete",
"error_message": "Document is blank"
},
{
"error": "incorrect_document_type",
"error_message": "Document is blank"
}
],
"uploaded_at": "2024-07-21T22:20:11.988Z"
}
],
"created_at": "2024-07-21T17:29:26.456Z",
"updated_at": "2024-07-22T11:53:48.998Z",
"business": {
"legal_name": "Innovaciones Tecnológicas de México S.A. de C.V.",
"trade_name": "La Justina Valle",
"entity_type": "Acme Inc.",
"incorporation_date": "2010-03-15",
"industries": [
"Tecnología de la Información",
"Desarrollo de Software"
],
"business_description": "Proveedor de soluciones de software basadas en la nube para pequeñas empresas en México",
"registration_details": {
"fme": "N-2023012345",
"jurisdiction": "Ciudad de México"
},
"tax_status": {
"rfc": "NVA120490XD2",
"status": "activo"
},
"contact_information": {
"primary_address": {
"exterior_number": " s/n.",
"locality": "Avon",
"cross_street_1": "Caserio Guadalupe",
"cross_street_2": "Vía Carla"
},
"additional_addresses": [
{
"exterior_number": " 8",
"interior_number": "Esc. 328",
"street_type": "Calle",
"street_name": "Masía Adela Amador",
"colony": "El Parque",
"city": "Hanford",
"state": "Ext",
"locality": "Cambridgeshire",
"cross_street_1": "Explanada Manuel",
"cross_street_2": "Ronda Arturo Holguín"
}
],
"phone_numbers": [
"+52 55 1234 5678",
"+52 55 8765 4321"
],
"email_addresses": [
"info@innovatech.mx",
"ventas@innovatech.mx"
]
},
"websites": [
{
"url": "https://www.example.com",
"last_analysis_date": "2023-07-21T14:30:00Z",
"website_status": "active",
"ssl_certificate": {
"present": true,
"valid_until": "2024-07-21",
"issued_to": "Example Corp"
},
"domain_information": {
"registration_date": "2010-01-15",
"expiration_date": "2025-01-15",
"registrar": "GoDaddy.com, LLC",
"registrant": "Example Corp"
},
"content_summary": {
"business_description": "Example Corp provides innovative software solutions for small businesses.",
"key_offerings": [
"Cloud Storage",
"Project Management Tool",
"Customer Support Software"
]
},
"key_pages": {
"about_us": "https://www.example.com/about",
"support": "https://www.example.com/support",
"privacy_policy": "https://www.example.com/privacy"
},
"contact_information": {
"emails": [
"info@example.com",
"support@example.com"
],
"phones": [
"+1 (555) 123-4567",
"+1 (555) 987-6543"
],
"addresses": [
"123 Main St, Anytown, AT 12345, USA"
]
},
"social_media_links": [
{
"platform": "Facebook",
"url": "https://www.facebook.com/examplecorp"
},
{
"platform": "LinkedIn",
"url": "https://www.linkedin.com/company/examplecorp"
}
],
"technologies_used": [
"WordPress",
"WooCommerce",
"Google Analytics"
],
"payment_methods": [
"Visa",
"MasterCard",
"PayPal",
"Apple Pay"
],
"red_flags": [
{
"type": "missing_contact_info",
"description": "No contact information found on the website",
"severity": "medium"
},
{
"type": "placeholder_content",
"description": "Placeholder content found on multiple pages",
"severity": "high"
}
]
},
{
"url": "https://www.example.com",
"last_analysis_date": "2023-07-21T14:30:00Z",
"website_status": "active",
"ssl_certificate": {
"present": true,
"valid_until": "2024-07-21",
"issued_to": "Example Corp"
},
"domain_information": {
"registration_date": "2010-01-15",
"expiration_date": "2025-01-15",
"registrar": "GoDaddy.com, LLC",
"registrant": "Example Corp"
},
"content_summary": {
"business_description": "Example Corp provides innovative software solutions for small businesses.",
"key_offerings": [
"Cloud Storage",
"Project Management Tool",
"Customer Support Software"
]
},
"key_pages": {
"about_us": "https://www.example.com/about",
"support": "https://www.example.com/support",
"privacy_policy": "https://www.example.com/privacy"
},
"contact_information": {
"emails": [
"info@example.com",
"support@example.com"
],
"phones": [
"+1 (555) 123-4567",
"+1 (555) 987-6543"
],
"addresses": [
"123 Main St, Anytown, AT 12345, USA"
]
},
"social_media_links": [
{
"platform": "Facebook",
"url": "https://www.facebook.com/examplecorp"
},
{
"platform": "LinkedIn",
"url": "https://www.linkedin.com/company/examplecorp"
}
],
"technologies_used": [
"WordPress",
"WooCommerce",
"Google Analytics"
],
"payment_methods": [
"Visa",
"MasterCard",
"PayPal",
"Apple Pay"
],
"red_flags": [
{
"type": "missing_contact_info",
"description": "No contact information found on the website",
"severity": "medium"
},
{
"type": "placeholder_content",
"description": "Placeholder content found on multiple pages",
"severity": "high"
}
]
},
{
"url": "https://www.example.com",
"last_analysis_date": "2023-07-21T14:30:00Z",
"website_status": "active",
"ssl_certificate": {
"present": true,
"valid_until": "2024-07-21",
"issued_to": "Example Corp"
},
"domain_information": {
"registration_date": "2010-01-15",
"expiration_date": "2025-01-15",
"registrar": "GoDaddy.com, LLC",
"registrant": "Example Corp"
},
"content_summary": {
"business_description": "Example Corp provides innovative software solutions for small businesses.",
"key_offerings": [
"Cloud Storage",
"Project Management Tool",
"Customer Support Software"
]
},
"key_pages": {
"about_us": "https://www.example.com/about",
"support": "https://www.example.com/support",
"privacy_policy": "https://www.example.com/privacy"
},
"contact_information": {
"emails": [
"info@example.com",
"support@example.com"
],
"phones": [
"+1 (555) 123-4567",
"+1 (555) 987-6543"
],
"addresses": [
"123 Main St, Anytown, AT 12345, USA"
]
},
"social_media_links": [
{
"platform": "Facebook",
"url": "https://www.facebook.com/examplecorp"
},
{
"platform": "LinkedIn",
"url": "https://www.linkedin.com/company/examplecorp"
}
],
"technologies_used": [
"WordPress",
"WooCommerce",
"Google Analytics"
],
"payment_methods": [
"Visa",
"MasterCard",
"PayPal",
"Apple Pay"
],
"red_flags": [
{
"type": "missing_contact_info",
"description": "No contact information found on the website",
"severity": "medium"
},
{
"type": "placeholder_content",
"description": "Placeholder content found on multiple pages",
"severity": "high"
}
]
}
],
"social_media_profiles": [
{
"platform": "Facebook",
"profile_url": "https://www.facebook.com/examplecorp",
"last_analysis_date": "2023-07-23T09:15:00Z",
"profile_name": "Example Corp",
"follower_count": 50000,
"following_count": 100,
"verified": true,
"posting_frequency": "daily",
"description": "Innovative solutions for small businesses",
"linked_websites": [
"https://www.examplecorp.com"
],
"recent_posts": [
{
"date": "2023-07-22T14:30:00Z",
"content": "Excited to announce our new product launch!",
"engagement": {
"likes": 500,
"comments": 50,
"shares": 25
}
}
],
"sentiment": "positive",
"common_themes": [
"product announcements",
"customer support",
"industry news"
],
"red_flags": [
{
"type": "inconsistent_information",
"description": "Business information conflicts with data from other sources",
"severity": "medium"
}
]
},
{
"platform": "Facebook",
"profile_url": "https://www.facebook.com/examplecorp",
"last_analysis_date": "2023-07-23T09:15:00Z",
"profile_name": "Example Corp",
"follower_count": 50000,
"following_count": 100,
"verified": true,
"posting_frequency": "daily",
"description": "Innovative solutions for small businesses",
"linked_websites": [
"https://www.examplecorp.com"
],
"recent_posts": [
{
"date": "2023-07-22T14:30:00Z",
"content": "Excited to announce our new product launch!",
"engagement": {
"likes": 500,
"comments": 50,
"shares": 25
}
}
],
"sentiment": "positive",
"common_themes": [
"product announcements",
"customer support",
"industry news"
],
"red_flags": [
{
"type": "inconsistent_information",
"description": "Business information conflicts with data from other sources",
"severity": "medium"
}
]
},
{
"platform": "Facebook",
"profile_url": "https://www.facebook.com/examplecorp",
"last_analysis_date": "2023-07-23T09:15:00Z",
"profile_name": "Example Corp",
"follower_count": 50000,
"following_count": 100,
"verified": true,
"posting_frequency": "daily",
"description": "Innovative solutions for small businesses",
"linked_websites": [
"https://www.examplecorp.com"
],
"recent_posts": [
{
"date": "2023-07-22T14:30:00Z",
"content": "Excited to announce our new product launch!",
"engagement": {
"likes": 500,
"comments": 50,
"shares": 25
}
}
],
"sentiment": "positive",
"common_themes": [
"product announcements",
"customer support",
"industry news"
],
"red_flags": [
{
"type": "inconsistent_information",
"description": "Business information conflicts with data from other sources",
"severity": "medium"
}
]
}
],
"product_analysis": {
"last_analysis_date": "2023-07-24T10:30:00Z",
"product_categories": [
"Electronics",
"Fashion Accessories",
"Software Services"
],
"pricing_analysis": {
"average_price": 1500,
"price_range": {
"min": 50,
"max": 25000
},
"unusual_pricing_patterns": [
{
"product_name": "Smartphone X",
"product_url": "https://example.com/products/smartphone-x",
"reason": "Price significantly lower than market average"
}
]
},
"risk_assessment": {
"high_risk_products": [
{
"product_name": "Cryptocurrency Service",
"product_url": "https://example.com/services/crypto",
"risk_factors": [
"High volatility",
"Potential use for money laundering"
],
"regulatory_requirements": [
"Registration with CNBV",
"Suspicious transaction reporting"
]
}
],
"fraud_and_counterfeit_risk": [
{
"product_name": "Designer Bags",
"product_url": "https://example.com/products/designer-bags",
"risk_type": "Counterfeit",
"risk_level": "High",
"description": "High risk of counterfeit products entering the supply chain"
}
]
},
"aml_risk_assessment": {
"overall_risk_level": "Medium",
"high_risk_products": [
{
"product_name": "International Transfers",
"product_url": "https://example.com/services/international-transfers",
"risk_factors": [
"High transaction volume",
"High-risk destinations"
]
}
]
},
"red_flags": [
{
"flag_type": "Missing Licenses",
"description": "The company offers multiple financial services without proper licenses",
"severity": "High"
}
]
},
"owners": [
{
"entity_type": "person",
"name": "Laura Puga",
"nationality": "Mexico",
"rfc": "MAC0511153G1",
"address": {
"exterior_number": " 3",
"interior_number": "Puerta 938",
"street_type": "Calle",
"locality": "Borders",
"cross_street_1": "Extrarradio Andrea",
"cross_street_2": "Urbanización Julia Suárez"
},
"date_of_birth": "2020-07-23",
"curp": "MAC0511153G13465",
"fixed_capital_value": "304.78",
"variable_capital_value": "425.13"
},
{
"entity_type": "person",
"name": "María de los Ángeles Sierra",
"nationality": "Mexico",
"rfc": "MAC0511153G1",
"address": {
"exterior_number": " 8",
"interior_number": "Esc. 312",
"locality": "Avon",
"cross_street_1": "Rampa Sancho",
"cross_street_2": "Monte Marco Antonio de Jesús"
},
"date_of_birth": "1979-03-10",
"curp": "MAC0511153G13465",
"fixed_capital_value": "575.19",
"variable_capital_value": "137.55"
}
],
"legal_representatives": [
{
"entity_type": "person",
"name": "Sta. Hermenegildo Fuentes",
"nationality": "Mexico",
"rfc": "MAC0511153G1",
"address": {
"exterior_number": " 29",
"interior_number": "Esc. 037",
"street_type": "Calle",
"street_name": "Masía Alberto",
"colony": "El Parque",
"city": "Reno",
"state": "Ext",
"postal_code": "53398",
"locality": "Cambridgeshire",
"cross_street_1": "Puente Elisa Tapia",
"cross_street_2": "Torrente Vicente"
},
"date_of_birth": "1965-10-13",
"curp": "MAC0511153G13465",
"role": "ad",
"powers": [
"minim cillum in",
"sed"
]
},
{
"entity_type": "person",
"name": "Laura Hidalgo",
"nationality": "Mexico",
"rfc": "MAC0511153G1",
"address": {
"locality": "Buckinghamshire",
"cross_street_1": "Chalet Manuela",
"cross_street_2": "Riera Rosario"
},
"date_of_birth": "1972-11-08",
"curp": "MAC0511153G13465",
"role": "nisi magna dolor sint",
"powers": [
"aliquip ut",
"in",
"id nulla"
]
}
]
}
}🟠404Not found