agosint

Company due diligence in one call (KYB, vendor and supplier checks). Give a company name and country, a registry number, an EU VAT number, an LEI or a website domain. Returns the legal entity from the official register, LEI and parents, VAT validity, a sanctions screen (OFAC, EU, UK) of the company and officers, and the domain's age, mail and TLS, as signed pass/warn/fail checks with sources. Use when you must decide whether to trust an unknown company. Not offered on Solana: pay on Base or Polygon.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "two-letter ISO country code; required with name or id; not used with lei, vat or domain",
      "pattern": "^[A-Za-z]{2}$",
      "type": "string"
    },
    "domain": {
      "description": "the company's website as a bare domain such as example.com; the legal entity is identified from the site's own legal notice, its certificate and public records, and the call is not charged when it cannot be",
      "maxLength": 253,
      "type": "string"
    },
    "id": {
      "description": "a register number of the country (CZ ICO, NO organisation number, GB company number, FR SIREN or SIRET, FI business id, DE register number such as HRB 12345, US CIK or ticker); use with country",
      "maxLength": 40,
      "type": "string"
    },
    "include": {
      "description": "the sections wanted; default all five",
      "items": {
        "enum": [
          "registry",
          "lei",
          "vat",
          "sanctions",
          "domain"
        ],
        "type": "string"
      },
      "maxItems": 5,
      "type": "array"
    },
    "lei": {
      "description": "a 20-character legal entity identifier",
      "pattern": "^[A-Za-z0-9]{18}[0-9]{2}$",
      "type": "string"
    },
    "name": {
      "description": "a company name; use with country. Send exactly one of name, id, lei, vat or domain",
      "maxLength": 120,
      "minLength": 2,
      "type": "string"
    },
    "vat": {
      "description": "an EU or Norwegian VAT number with its country prefix, such as CZ45274649",
      "maxLength": 20,
      "type": "string"
    }
  },
  "additionalProperties": false
}

Business registry lookup: company identity and legal entity enrichment as structured JSON, by registration number, name and country, VAT number, LEI or website. Registers of Czechia, Norway, the United Kingdom, France, Finland, US SEC filers and every LEI holder. Use when: you need the official identity of one company.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "two-letter ISO country code; required with id or name; CZ, NO, GB and US have their own official register, any other country is looked up in GLEIF",
      "pattern": "^[A-Za-z]{2}$",
      "type": "string"
    },
    "domain": {
      "description": "a company website as a bare domain: the legal entity is identified from the site's legal notice, certificate and public records and its register record returned; not charged when the site cannot be tied to one company",
      "maxLength": 253,
      "type": "string"
    },
    "id": {
      "description": "the register id: CZ ICO, NO organisation number, GB company number, US ticker or CIK, or a registration number for other countries",
      "maxLength": 40,
      "type": "string"
    },
    "lei": {
      "description": "a 20-character legal entity identifier (any country; no country needed); when the entity's own register is one we read, that record is returned with the LEI and its parents",
      "pattern": "^[A-Za-z0-9]{18}[0-9]{2}$",
      "type": "string"
    },
    "name": {
      "description": "a company name; several matches return a short candidate list with ids",
      "maxLength": 120,
      "minLength": 2,
      "type": "string"
    },
    "vat": {
      "description": "a VAT number of a country whose number contains the register id (CZ, FR, FI, NO); no country needed. Send exactly one of id, name, lei, vat or domain",
      "maxLength": 20,
      "type": "string"
    }
  },
  "additionalProperties": false
}

German commercial register (Handelsregister) record: register court and number, legal form, status, seat, capital, representation rules, officers and history. Slower (about a minute). Use when: the company is German. Not offered on Solana: pay on Base or Polygon.

{
  "type": "object",
  "properties": {
    "city": {
      "description": "seat city",
      "maxLength": 80,
      "type": "string"
    },
    "include_deleted": {
      "default": false,
      "description": "also return companies deleted from the register",
      "type": "boolean"
    },
    "legal_form": {
      "description": "legal form, e.g. GmbH or AG",
      "maxLength": 80,
      "type": "string"
    },
    "limit": {
      "default": 1,
      "description": "most company records to return and pay for (1 to 5, default 1)",
      "maximum": 5,
      "minimum": 1,
      "type": "integer"
    },
    "match": {
      "default": "all",
      "description": "how the words of the name combine",
      "enum": [
        "all",
        "any",
        "exact"
      ],
      "type": "string"
    },
    "name": {
      "description": "company name words as in the register",
      "maxLength": 120,
      "minLength": 2,
      "type": "string"
    },
    "postal_code": {
      "description": "seat postal code",
      "maxLength": 10,
      "type": "string"
    },
    "register_court": {
      "description": "the register court, e.g. München",
      "maxLength": 80,
      "type": "string"
    },
    "register_number": {
      "description": "exact register number",
      "maxLength": 40,
      "type": "string"
    },
    "register_type": {
      "description": "restrict to one register",
      "enum": [
        "HRA",
        "HRB",
        "GnR",
        "PR",
        "VR",
        "GsR"
      ],
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Domain intelligence and phishing-risk signals: domain age and expiry (RDAP/WHOIS), registrar, DNS (A, AAAA, MX, NS, TXT, CAA), SPF, DMARC and MTA-STS, DNSSEC, TLS certificate issuer and expiry, hosting network, and the company behind the site when it can be identified. Use when: deciding whether a domain, link or email sender is legitimate, or checking a domain's mail setup.

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "a public domain name such as example.com (an internationalised name is accepted); no URL, port or IP address",
      "maxLength": 253,
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

IP address or AS number lookup: holder, announced prefixes, origin AS, country, RPKI status and abuse contact. Use when: you need to know who runs an IP address or network.

{
  "type": "object",
  "properties": {
    "asn": {
      "description": "an AS number such as AS3333 or 3333",
      "maxLength": 12,
      "type": "string"
    },
    "ip": {
      "description": "a public IPv4 or IPv6 address",
      "maxLength": 45,
      "type": "string"
    }
  },
  "additionalProperties": false
}

Sanctions screening against the official OFAC SDN, EU consolidated and UK lists with fuzzy name matching, a score per hit, the programme and each list's publication date. Screen a company or person name (optionally with country or birth date) or a crypto wallet address. Use when: screening a counterparty, supplier, customer or wallet before a payment or onboarding. A screening aid, not a compliance determination.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "description": "a person's birth date, YYYY or YYYY-MM-DD; reported as corroboration of each hit",
      "pattern": "^\\d{4}(-\\d{2}-\\d{2})?$",
      "type": "string"
    },
    "country": {
      "description": "the subject's country (ISO code or English name); reported as corroboration of each hit, it does not change the score",
      "maxLength": 60,
      "type": "string"
    },
    "kind": {
      "default": "any",
      "description": "restrict matches to organisations (and vessels, aircraft) or to persons",
      "enum": [
        "entity",
        "person",
        "any"
      ],
      "type": "string"
    },
    "lists": {
      "description": "the lists to screen (default: all four)",
      "items": {
        "enum": [
          "ofac-sdn",
          "eu-fsf",
          "uk-sl",
          "un-sc"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "description": "the company or person name to screen; send either name or wallet",
      "maxLength": 200,
      "minLength": 2,
      "type": "string"
    },
    "threshold": {
      "default": 0.85,
      "description": "the lowest match score reported; 1.00 is an exact name or alias, 0.98 the same words in another order, lower scores are fuzzy matches",
      "maximum": 1,
      "minimum": 0.7,
      "type": "number"
    },
    "wallet": {
      "description": "a crypto wallet address; an exact match against the digital-currency addresses listed on the OFAC SDN list (EVM addresses are case-insensitive)",
      "maxLength": 120,
      "type": "string"
    }
  },
  "additionalProperties": false
}

EU VAT number validation against the official VIES service: valid or invalid, registered name and address, an optional check of the name you expect and, if you give your own VAT number, a VIES consultation number to keep as audit evidence. Norwegian numbers are checked against the Norwegian VAT register. Use when: onboarding an EU supplier or customer, or before paying an invoice.

{
  "type": "object",
  "properties": {
    "expect_name": {
      "description": "the company name you expect; the answer says whether it matches the registered name (match, partial, mismatch or not_checked)",
      "maxLength": 200,
      "type": "string"
    },
    "requester_vat": {
      "description": "your own EU VAT number: VIES then issues a consultation number, proof of the check to keep as audit evidence (not for Norwegian numbers)",
      "maxLength": 20,
      "type": "string"
    },
    "vat": {
      "description": "the VAT number to check, with its country prefix (an EU member state, or NO for Norway), e.g. CZ45274649",
      "maxLength": 20,
      "type": "string"
    }
  },
  "required": [
    "vat"
  ],
  "additionalProperties": false
}

Free check before you pay: whether a request can be answered and what it would return. Up to three matching companies (name, number, country, status), whether a VAT number's format and check digit are valid, whether a domain resolves and has mail servers, and the price. Use when: you are not sure the paid call will find the right subject.

{
  "type": "object",
  "properties": {
    "input": {
      "description": "the body you would send to that route",
      "type": "object"
    },
    "route": {
      "description": "the route to preview: due-diligence, company, company-de, domain, network, sanctions, vat",
      "type": "string"
    }
  },
  "required": [
    "route"
  ],
  "additionalProperties": false
}

Free: verify the signature and content hash of an agosint answer.

{
  "type": "object",
  "properties": {
    "record": {
      "description": "one record exactly as delivered, receipt included",
      "type": "object"
    }
  },
  "required": [
    "record"
  ],
  "additionalProperties": false
}

Free. Tell the people who run this service what worked, what failed or what you miss: a bug, an idea or a thanks. A person reads it. No payment, no account; limited to a few messages an hour.

{
  "type": "object",
  "properties": {
    "contact": {
      "description": "optional: how we can reach you or your operator",
      "maxLength": 200,
      "type": "string"
    },
    "kind": {
      "default": "other",
      "enum": [
        "bug",
        "idea",
        "praise",
        "other"
      ],
      "type": "string"
    },
    "message": {
      "description": "what worked, what did not, what you miss; no secrets or private data",
      "maxLength": 2000,
      "type": "string"
    },
    "route": {
      "description": "the route the feedback is about, if any",
      "enum": [
        "due-diligence",
        "company",
        "company-de",
        "domain",
        "network",
        "sanctions",
        "vat"
      ],
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "additionalProperties": false
}