--- title: "List checks for a business" method: GET path: "/businesses/{business_id}/checks" tags: ["Business Checks"] --- # List checks for a business `GET /businesses/{business_id}/checks` Lists all checks for a business specified by ID. ## Response `200` OK - object — List of business checks. - `data` union[], required - union - object - `id` string, uuid, required — Business Check unique identifier. - `business_id` string, uuid, required — Unique identifier for the business. - `type` string, required — The type of check must be “KYB”. - `originally_confirmed_at` string, date-time, required — The date and time when the check was first confirmed. When the check has only been confirmed once, this value is the same as check_confirmed_at. When renewing KYB check, this value remains the same as when the check was first confirmed. - `check_confirmed_at` string, date-time, required — The date and time when the check was latest confirmed - `status` 'IN_PROGRESS' | 'PASSED' | 'FAILED', required — Final status of the business check. * IN_PROGRESS - Check is in progress * PASSED - Check passed * FAILED - Check failed - `data_download_link` string, uri, required - `document_type` string, required - object — The Business Self Assessment check captures information about the business's activities, financials, and purpose of the business relationship for risk scoring. - `id` string, uuid, required — Business Check unique identifier. - `business_id` string, uuid, required — Unique identifier for the business. - `type` string, required — The type of check must be "BUSINESS_SELF_ASSESSMENT". - `check_confirmed_at` string, date-time, required — The date and time when the self assessment check was confirmed. - `status` 'IN_PROGRESS' | 'PASSED' | 'FAILED', required — Final status of the business check. * IN_PROGRESS - Check is in progress * PASSED - Check passed * FAILED - Check failed - `business_industry` 'ACCOMMODATION_AND_HOSPITALITY' | 'ACCOMMODATION_AND_HOSPITALITY_TIMESHARING' | 'ADMIN_AND_SUPPORT_SERVICES' | 'ADMIN_AND_SUPPORT_SERVICES_CLEANING_AND_FACILITIES' | 'ADMIN_AND_SUPPORT_SERVICES_SECURITY_AND_INVESTIGATION' | 'ADMIN_AND_SUPPORT_SERVICES_SPECIFIC_SECTORS' | 'AGRICULTURE_FORESTRY_AND_FISHING' | 'CONSTRUCTION' | 'EDUCATION' | 'EDUCATION_HIGHER_EDUCATION' | 'ENTERTAINMENT_ARTS_AND_RECREATION' | 'ENTERTAINMENT_ARTS_AND_RECREATION_NATURE_AND_ZOOS' | 'ENTERTAINMENT_ARTS_AND_RECREATION_SPECIFIC_SECTORS' | 'EXTRATERRITORIAL_AND_HOUSEHOLD_ACTIVITIES' | 'FINANCIAL_SERVICES' | 'FOOD_AND_BEVERAGE_SERVICES' | 'HEALTHCARE' | 'HEALTHCARE_COUNSELLING_AND_SOCIAL_SERVICES' | 'INFORMATION_TECHNOLOGY_AND_MEDIA' | 'INFORMATION_TECHNOLOGY_AND_MEDIA_ONLINE_GAMING' | 'INFORMATION_TECHNOLOGY_AND_MEDIA_PRINT_PUBLISHING' | 'INFORMATION_TECHNOLOGY_AND_MEDIA_TELECOMMUNICATIONS' | 'MANUFACTURING' | 'MANUFACTURING_PHARMACEUTICALS' | 'MANUFACTURING_PRECIOUS_METALS_AND_JEWELLERY' | 'MANUFACTURING_WEAPONS_AND_HAZARDOUS' | 'MINING_AND_QUARRYING' | 'PERSONAL_AND_OTHER_SERVICES' | 'PERSONAL_AND_OTHER_SERVICES_ADULT_AND_WELLNESS' | 'PERSONAL_AND_OTHER_SERVICES_NONPROFIT_AND_MEMBERSHIP_ORGANISATIONS' | 'PROFESSIONAL_AND_TECHNICAL_SERVICES' | 'PROFESSIONAL_AND_TECHNICAL_SERVICES_LEGAL_AND_FIDUCIARY' | 'PROFESSIONAL_AND_TECHNICAL_SERVICES_UNREGULATED' | 'PUBLIC_ADMINISTRATION' | 'PUBLIC_ADMINISTRATION_JUDICIAL' | 'REAL_ESTATE' | 'REAL_ESTATE_AGENCY_AND_BROKERAGE' | 'RETAIL_TRADE' | 'RETAIL_TRADE_SPECIALITY' | 'RETAIL_TRADE_SPECIFIC_SECTORS' | 'TRANSPORTATION_AND_LOGISTICS' | 'TRANSPORTATION_AND_LOGISTICS_CRUISE_LINES' | 'TRANSPORTATION_AND_LOGISTICS_RAIL_AND_STORAGE' | 'UTILITIES_AND_ENERGY' | 'WHOLESALE_TRADE' | 'WHOLESALE_TRADE_INDUSTRIAL' | 'WHOLESALE_TRADE_LUXURY_AND_COLLECTIBLES' | 'WHOLESALE_TRADE_PETROLEUM_AND_CHEMICALS', required — The business industry classification. - `purpose_of_business_relationship` 'WEALTH_GROWTH' | 'TREASURY_LIQUIDITY_MANAGEMENT' | 'HEDGING_RISK_MANAGEMENT' | 'EMPLOYEE_BENEFIT_FUNDING' | 'STRATEGIC_INVESTMENT', required — The purpose of the business relationship. - `primary_countries_of_activity` string[], required — List of primary countries where the business operates. ISO 3166-1 alpha-2 country codes. - `annual_revenue` object, required — A monetary range defined by a lower bound and an optional upper bound. - `currency` 'EUR' | 'GBP', required — Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR - Euro * GBP - Pound Sterling - `lower_bound` number, required — The lower bound of the monetary range. - `upper_bound` number — The upper bound of the monetary range. - `expected_volume_of_investment` object, required — A monetary range defined by a lower bound and an optional upper bound. - `currency` 'EUR' | 'GBP', required — Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR - Euro * GBP - Pound Sterling - `lower_bound` number, required — The lower bound of the monetary range. - `upper_bound` number — The upper bound of the monetary range. - `total_asset_value` object, required — A monetary range defined by a lower bound and an optional upper bound. - `currency` 'EUR' | 'GBP', required — Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR - Euro * GBP - Pound Sterling - `lower_bound` number, required — The lower bound of the monetary range. - `upper_bound` number — The upper bound of the monetary range. ## Other responses - `401` — Unauthorized. The caller has not been authenticated. - `403` — Forbidden. The caller has been authenticated but is not allowed to take the requested action. - `404` — Not Found. The requested resource could not be found. - `406` — Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value. - `429` — Too Many Requests. The caller has exceeded their quota for the time period and has been throttled. - `500` — Internal Server Error. The service encountered an unexpected error. - `503` — Service Unavailable. The service handling for this request cannot be reached at this time. - `504` — Gateway Timeout. The service gateway has reached its internal timeout. --- [API](https://skmtc.net/upvest/apis/upvest-investment-api.md) · [All operations](https://skmtc.net/upvest/apis/upvest-investment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upvest/upvest-investment-api/revisions/2c6bc192bc09/schema)