# AML/KYC results Endpoints for retrieving AML/KYC assessments, including risk rating, acceptance status, PEP/sanction screening, and document completeness. ## GET /v1.1/business-relations/{crmCode}/aml-kyc-result > Retrieve AML/KYC results for a business relation ```json {"openapi":"3.0.3","info":{"title":"Apentis API","version":"1.1.0"},"tags":[{"name":"AML/KYC results","description":"Endpoints for retrieving AML/KYC assessments, including risk rating, acceptance status, PEP/sanction screening, and document completeness."}],"servers":[{"url":"https://www.riskquadrant.com/api","description":"API for Production environment - Luxembourg"},{"url":"https://www.riskquadrant.ch/api","description":"API for Production environment - Switzerland"},{"url":"https://www.rq-test.com/api","description":"API for Test environment (for sandbox integration)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AmlKycResult":{"type":"object","properties":{"amlRiskRating":{"type":"string","enum":["low","medium","high"],"description":"The overall risk level assigned to a business relation based on the combination of screening results (PEP, sanctions, adverse media), country risk, business activity, and other risk attributes. It determines whether the relationship is considered Low, Medium, or High risk from an Anti-Money Laundering and Counter-Terrorism Financing (AML/CTF) standpoint."},"dueDiligenceType":{"type":"string","enum":["simplified","standard","enhanced"],"description":"Specifies whether the business relation requires additional verification and monitoring measures beyond standard KYC checks, due to the AML risk level or specific red flags."},"relationAcceptanceStatus":{"type":"string","enum":["approved","conditional","revoked"],"description":"Indicates the internal decision regarding the acceptance of the business relation following the AML assessment."},"accountStatus":{"type":"string","enum":["active","soft blocked","hard blocked"],"description":"Shows the operational status of the client’s account based on AML findings and internal controls."},"blockingReason":{"type":"string","enum":["account_opening_pending_approval","aml_escalation_suspicious","aml_review_pending","expired_kyc","fiu_regulatory_request","fraud","legal","missing_documents","tax_non_compliance"],"description":"Optional reason for account blocking; applicable only when accountStatus is soft blocked or hard blocked."},"nbrHits":{"type":"integer","format":"int32","description":"Total number of AML screening hits identified for the business relation."},"nbrArticles":{"type":"integer","format":"int32","description":"Total number of adverse media (bad press) articles linked to the business relation."},"isPep":{"type":"boolean","description":"Whether the business relation is identified as a Politically Exposed Person (PEP)."},"isSanctioned":{"type":"boolean","description":"Whether the business relation appears on a sanctions list."},"amlReviewedBy":{"type":"string","description":"Name or identifier of the compliance officer who last reviewed the AML data."},"amlReviewDate":{"type":"string","format":"date","description":"Date (YYYY-MM-DD) when the AML review was performed."},"kycStatus":{"type":"string","enum":["to review","reviewed"],"description":"KYC review status of the business relation."},"lastKycReviewDate":{"type":"string","format":"date","description":"Date of the most recent KYC review (YYYY-MM-DD)."},"nextKycReviewDate":{"type":"string","format":"date","description":"Date of the next KYC review (YYYY-MM-DD)."},"missingDocuments":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeEnum"},"description":"List of missing document types."},"expiredDocuments":{"type":"array","items":{"$ref":"#/components/schemas/DocumentTypeEnum"},"description":"List of expired document types."},"kycReviewedBy":{"type":"string","description":"Name or identifier of the compliance officer who last reviewed the KYC data."},"kycReviewDate":{"type":"string","format":"date","description":"Date (YYYY-MM-DD) when the KYC review was performed."}}},"DocumentTypeEnum":{"type":"string","description":"Document types. See the \"Document types\" reference list in GitBook.","enum":["account_valuation","Acknowledgement of receipt","Advisory mandate contract","AML risk assessment","aml_letter","Annual accounts (audited)","Annual accounts (unaudited)","Annual report","articles_of_incorporation","Bank account details","Bank statement","business_continuity_plan","Certificate of accommodation","Certificate of good standing","certificate of incorporation","Certificate of incumbency","Certificate of insurance","Civil partnership certificate","Client acceptance doc","client_profile","Collateral agreement","Consumer loan agreement","Copy of transaction notices","Corporate structure","Criminal record","CRS self-certification","DAC 6","death_certificate","declaration_of_BO","deed","Discretionary mandate contract","Divorce judgment","Driving licence","Eligibility assessment","Employment certificate","Employment contract","End of relationship doc","Engagement letter","entering business relationship","Family record book","FATCA classification","Financial statement","Financing plan","general_conditions","Health insurance card","ID card scan","investment_profile","KYC Form","kyc_report","Life insurance contract","list_authorized_signatures","Management agreement","Marriage certificate","Memorandum of association","MIFID classification","MIFID form","Mortgage loan agreement","name_check","Others","Passport","Pay slip","Phone subscription","power_of_attorney","Proof of domicile","Proof of listing","Proof of origin of capital","Proof of regulation","Proof of supervision","PV board of directors","PV BoD","PV general assembly","RCS","Register of beneficial owners","Register of directors","Register of shareholders","Resident card","RTO mandate contract","Separation agreement","Status","Structure chart","Tax notice","Tax registration number","termination_letter","Trade / Economic license","Transaction record","Tripartite agreement","Unique Identification Number","utility_bill","VAT registration certificate","VISA page","visit_report","W-8BEN","W-9"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Short description of the error"},"code":{"type":"integer","description":"Application-specific or HTTP error code"}}}}},"paths":{"/v1.1/business-relations/{crmCode}/aml-kyc-result":{"get":{"summary":"Retrieve AML/KYC results for a business relation","tags":["AML/KYC results"],"parameters":[{"in":"path","name":"crmCode","required":true,"schema":{"type":"string"},"description":"Unique external identifier of the business relation."}],"responses":{"200":{"description":"AML/KYC results retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmlKycResult"}}}},"401":{"description":"Unauthorized - Missing or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found - Business relation not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Download the latest NameCheck report for a business relation > Returns the most recently generated NameCheck report as a PDF document. ```json {"openapi":"3.0.3","info":{"title":"Apentis API","version":"1.1.0"},"tags":[{"name":"AML/KYC results","description":"Endpoints for retrieving AML/KYC assessments, including risk rating, acceptance status, PEP/sanction screening, and document completeness."}],"servers":[{"url":"https://www.riskquadrant.com/api","description":"API for Production environment - Luxembourg"},{"url":"https://www.riskquadrant.ch/api","description":"API for Production environment - Switzerland"},{"url":"https://www.rq-test.com/api","description":"API for Test environment (for sandbox integration)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Short description of the error"},"code":{"type":"integer","description":"Application-specific or HTTP error code"}}}}},"paths":{"/v1.1/business-relations/{crmCode}/aml-kyc-report":{"get":{"summary":"Download the latest NameCheck report for a business relation","description":"Returns the most recently generated NameCheck report as a PDF document.","tags":["AML/KYC results"],"parameters":[{"in":"path","name":"crmCode","required":true,"schema":{"type":"string"},"description":"Unique external identifier of the business relation."}],"responses":{"200":{"description":"Latest NameCheck report retrieved successfully","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized - Missing or invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found - Report not available for the specified business relation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://apentis.gitbook.io/apentis-api/api-reference/aml-kyc-results.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.