Sample code for 30+ languages & platforms
Rust

Cerved API Advanced Entity Search

See more Cerved Examples

The "Advanced Entity Search" API allows you to find subjects in the Cerved database that meet specific search criteria, specified through the parameters provided as input to the service.

Chilkat Rust Downloads

Rust

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

let http = chilkat::Http::new();

// Implements the following CURL command:

// curl -X POST \
//   https://api.cerved.com/cervedApi/v1/entitySearch/advanced \
//   -H 'accept: application/json' \
//   -H 'apikey: ********************************' \
// -d '{
//   "search_text": "string",
//   "activity_status_codes": [
//     "A",
//     "C",
//     "D",
//     "F",
//     "I",
//     "L",
//     "N",
//     "P",
//     "R",
//     "S",
//     "T"
//   ],
//   "birth_date": "string",
//   "name": "string",
//   "subject_types": [
//     "PERSON",
//     "INDIVIDUAL_COMPANY",
//     "COMPANY",
//     "FOREIGN",
//     "OTHER"
//   ],
//   "tax_code": "string",
//   "vat_number": "string",
//   "rea": {
//     "cciaa": "string",
//     "rea_number": 0
//   },
//   "city_istat_code": "string",
//   "province_code": "string"
// }'

// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "search_text": "string",
//   "activity_status_codes": [
//     "A",
//     "C",
//     "D",
//     "F",
//     "I",
//     "L",
//     "N",
//     "P",
//     "R",
//     "S",
//     "T"
//   ],
//   "birth_date": "string",
//   "name": "string",
//   "subject_types": [
//     "PERSON",
//     "INDIVIDUAL_COMPANY",
//     "COMPANY",
//     "FOREIGN",
//     "OTHER"
//   ],
//   "tax_code": "string",
//   "vat_number": "string",
//   "rea": {
//     "cciaa": "string",
//     "rea_number": 0
//   },
//   "city_istat_code": "string",
//   "province_code": "string"
// }

let json = chilkat::JsonObject::new();
// IMPORTANT:  Only include the lines for the search criteria you wish to include.
let _ = json.update_string("search_text", "string");
let _ = json.update_string("activity_status_codes[0]", "A");
let _ = json.update_string("activity_status_codes[1]", "C");
let _ = json.update_string("activity_status_codes[2]", "D");
let _ = json.update_string("activity_status_codes[3]", "F");
let _ = json.update_string("activity_status_codes[4]", "I");
let _ = json.update_string("activity_status_codes[5]", "L");
let _ = json.update_string("activity_status_codes[6]", "N");
let _ = json.update_string("activity_status_codes[7]", "P");
let _ = json.update_string("activity_status_codes[8]", "R");
let _ = json.update_string("activity_status_codes[9]", "S");
let _ = json.update_string("activity_status_codes[10]", "T");
let _ = json.update_string("birth_date", "string");
let _ = json.update_string("name", "string");
let _ = json.update_string("subject_types[0]", "PERSON");
let _ = json.update_string("subject_types[1]", "INDIVIDUAL_COMPANY");
let _ = json.update_string("subject_types[2]", "COMPANY");
let _ = json.update_string("subject_types[3]", "FOREIGN");
let _ = json.update_string("subject_types[4]", "OTHER");
let _ = json.update_string("tax_code", "string");
let _ = json.update_string("vat_number", "string");
let _ = json.update_string("rea.cciaa", "string");
let _ = json.update_int("rea.rea_number", 0);
let _ = json.update_string("city_istat_code", "string");
let _ = json.update_string("province_code", "string");

http.set_request_header("accept", "application/json");
http.set_request_header("apikey", "********************************");

let resp = chilkat::HttpResponse::new();
if http.http_json("POST", "https://api.cerved.com/cervedApi/v1/entitySearch/advanced", &json, "application/json", &resp).is_err() {
    println!("{}", http.last_error_text());
    return;
}

let sb_response_body = chilkat::StringBuilder::new();
let _ = resp.get_body_sb(&sb_response_body);
let j_resp = chilkat::JsonObject::new();
let _ = j_resp.load_sb(&sb_response_body);
j_resp.set_emit_compact(false);

println!("Response Body:");
println!("{}", j_resp.emit().unwrap_or_default());

let resp_status_code = resp.status_code();
println!("Response Status Code = {}", resp_status_code);
if resp_status_code >= 400 {
    println!("Response Header:");
    println!("{}", resp.header());
    println!("Failed.");
    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "subjects": [
//     {
//       "subject_id": "string",
//       "subject_type": "string",
//       "tax_code": "string",
//       "address": {
//         "street": {
//           "description": "string"
//         },
//         "city": {
//           "code": "string",
//           "istat_code": "string",
//           "description": "string"
//         },
//         "province": {
//           "code": "string",
//           "description": "string"
//         },
//         "postal_code": "string",
//         "country": {
//           "code": "string",
//           "description": "string"
//         }
//       },
//       "company_info": {
//         "legal_form": {
//           "code": "string",
//           "description": "string",
//           "class_code": "string"
//         },
//         "activity_status": {
//           "code": "string",
//           "description": "string"
//         },
//         "business_name": "string",
//         "economic_activity": {
//           "ateco": {
//             "code": "string",
//             "description": "string"
//           }
//         },
//         "head_office": "true",
//         "lei_code": "string",
//         "operational_flag": "true",
//         "public_administration": {
//           "pa_subject": "true",
//           "pa_supplier": "true",
//           "pa_owned": "true"
//         },
//         "rea_code": {
//           "cciaa": "string",
//           "rea_number": 0,
//           "registration_date": "string"
//         },
//         "vat_number": "string",
//         "no_rea_data": {
//           "form_code": "string",
//           "form_description": "string"
//         }
//       },
//       "person_info": {
//         "first_name": "string",
//         "last_name": "string",
//         "name": "string",
//         "birth_date": "string",
//         "birth_place": {
//           "street": {
//             "description": "string"
//           },
//           "city": {
//             "code": "string",
//             "istat_code": "string",
//             "description": "string"
//           },
//           "province": {
//             "code": "string",
//             "description": "string"
//           },
//           "postal_code": "string",
//           "country": {
//             "code": "string",
//             "description": "string"
//           }
//         }
//       }
//     }
//   ],
//   "subjects_total_number": 0
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

let subjects_total_number = j_resp.int_of("subjects_total_number");
let mut i = 0;
let count_i = j_resp.size_of_array("subjects");
while i < count_i {
    j_resp.set_i(i);
    let _ = j_resp.string_of("subjects[i].subject_id").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].subject_type").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].tax_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.street.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.city.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.city.istat_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.city.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.province.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.province.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.postal_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.country.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].address.country.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.legal_form.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.legal_form.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.legal_form.class_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.activity_status.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.activity_status.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.business_name").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.economic_activity.ateco.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.economic_activity.ateco.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.head_office").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.lei_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.operational_flag").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.public_administration.pa_subject").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.public_administration.pa_supplier").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.public_administration.pa_owned").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.rea_code.cciaa").unwrap_or_default();
    let _ = j_resp.int_of("subjects[i].company_info.rea_code.rea_number");
    let _ = j_resp.string_of("subjects[i].company_info.rea_code.registration_date").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.vat_number").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.no_rea_data.form_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].company_info.no_rea_data.form_description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.first_name").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.last_name").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.name").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_date").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.street.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.city.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.city.istat_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.city.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.province.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.province.description").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.postal_code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.country.code").unwrap_or_default();
    let _ = j_resp.string_of("subjects[i].person_info.birth_place.country.description").unwrap_or_default();
    i = i + 1;
}