vynco 2.4.1

Rust SDK for the VynCo Swiss Corporate Intelligence API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use reqwest::Method;

use crate::client::Client;
use crate::error::Result;
use crate::response::Response;
use crate::types::{OwnershipRequest, OwnershipResponse};

/// Ownership trace operations.
///
/// For ultimate beneficial owner resolution use [`crate::Companies::ubo`] —
/// this resource exposes the lower-level ownership-chain trace endpoint
/// that walks head-office / branch-office / acquisition relationships
/// upward and detects circular ownership.
pub struct Ownership<'a> {
    client: &'a Client,
}

impl<'a> Ownership<'a> {
    pub(crate) fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// Trace the ownership chain upward from a company.
    ///
    /// Walks head-office / branch-office relationships up to
    /// `req.max_depth` levels (default 10 on the server, max 20),
    /// detecting circular ownership and identifying key persons.
    pub async fn trace(
        &self,
        uid: &str,
        req: &OwnershipRequest,
    ) -> Result<Response<OwnershipResponse>> {
        self.client
            .request_with_body(Method::POST, &format!("/v1/ownership/{uid}"), req)
            .await
    }
}

#[cfg(test)]
mod tests {
    use crate::{Client, OwnershipRequest};

    #[tokio::test]
    async fn test_ownership_trace() {
        let mut server = mockito::Server::new_async().await;
        let mock = server
            .mock("POST", "/v1/ownership/CHE-101.329.561")
            .with_status(200)
            .with_header("content-type", "application/json")
            .with_body(r#"{"uid":"CHE-101.329.561","companyName":"UBS SA","ownershipChain":[],"ultimateParent":null,"keyPersons":[],"circularFlags":[],"riskLevel":"low","assessedAt":"2026-04-12T00:00:00Z"}"#)
            .create_async()
            .await;
        let client = Client::builder("vc_test_key")
            .base_url(server.url())
            .build()
            .unwrap();
        let req = OwnershipRequest { max_depth: Some(5) };
        let resp = client
            .ownership()
            .trace("CHE-101.329.561", &req)
            .await
            .unwrap();
        assert_eq!(resp.data.uid, "CHE-101.329.561");
        assert_eq!(resp.data.risk_level, "low");
        mock.assert_async().await;
    }
}