curl --request POST \
  --url https://api.pubrio.com/companies/cloud_footprints/lookup \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "cloud_footprint_id": "f28215e6-f6ed-40c2-ac9b-d8e70164c0be"
}
'

import requests

url = "https://api.pubrio.com/companies/cloud_footprints/lookup"

payload = { "cloud_footprint_id": "f28215e6-f6ed-40c2-ac9b-d8e70164c0be" }
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({cloud_footprint_id: 'f28215e6-f6ed-40c2-ac9b-d8e70164c0be'})
};

fetch('https://api.pubrio.com/companies/cloud_footprints/lookup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/companies/cloud_footprints/lookup",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'cloud_footprint_id' => 'f28215e6-f6ed-40c2-ac9b-d8e70164c0be'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pubrio.com/companies/cloud_footprints/lookup"

	payload := strings.NewReader("{\n  \"cloud_footprint_id\": \"f28215e6-f6ed-40c2-ac9b-d8e70164c0be\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("pubrio-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/cloud_footprints/lookup")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cloud_footprint_id\": \"f28215e6-f6ed-40c2-ac9b-d8e70164c0be\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/companies/cloud_footprints/lookup")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"cloud_footprint_id\": \"f28215e6-f6ed-40c2-ac9b-d8e70164c0be\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "country_name": "United States",
    "hosts": [
      {
        "city": "Chicago",
        "cloud_region": null,
        "last_seen_at": "2026-09-03T23:09:52.811787",
        "first_seen_at": "2026-09-03T23:09:52.811787"
      },
      {
        "city": "Chicago",
        "cloud_region": null,
        "last_seen_at": "2026-07-28T16:23:24.323615",
        "first_seen_at": "2026-07-28T16:23:24.323615"
      }
    ],
    "regions": [],
    "cloud_footprint_id": "e82b2bd0-9971-41da-809b-ee4f2cf3305e",
    "domain_search_id": "01604baf-ab2d-4930-a867-2fced349f4f4",
    "provider": "Linode",
    "country_code": "US",
    "company_country_code": "IN",
    "is_home_market": false,
    "host_count": 2,
    "server_count": 3,
    "shared_server_count": 3,
    "region_count": 0,
    "city_count": 1,
    "cloud_regions": null,
    "cities": [
      "Chicago"
    ],
    "first_seen_at": "2026-07-28T16:23:24.323Z",
    "last_seen_at": "2026-09-03T23:09:52.811Z",
    "last_modified": "2026-09-04T09:30:52.103Z",
    "companies": {
      "logo_url": "https://buckets.pubrio.com/company-logo/OTg2Mzk1MjVpbGo5c3NuajFiaG9wYWxzZXJ2aWNlY2VudHJlLmNvbQ==.jpg",
      "domain_search_id": "01604baf-ab2d-4930-a867-2fced349f4f4",
      "company_name": "bhopalservicecentre.com",
      "linkedin_name": null,
      "country_code": "IN",
      "company_url": "http://www.bhopalservicecentre.com",
      "domain": "bhopalservicecentre.com"
    },
    "evidence_url": "https://www.pubrio.com/evidence/9c6ae876b7bf39f0a5beed66a7ad689e"
  }
}

{
  "code": 40001,
  "message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}