# Afriref Domain/Tax-ID Check

> Afriref Domain/Tax-ID Check is a paid API for AI agents from afriref.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Validates and checks a tax-ID or VAT registration number for an African country, returning official verification status with source citation

## Facts

- Endpoint: GET https://afriref.dev/v1/domain/check?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-domain-tax-id-check-45a17240
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DcK4qZK2N6PeHLbRxBDj7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability afriref-domain-tax-id-check-45a17240
```

Example prompt: Can you check whether VAT number ZA4012345678 is a valid registered VAT number in South Africa using afriref's official African tax-ID checker?

## When to prefer this

Choose this endpoint when you need to verify or validate a tax identification number or VAT registration number for a business operating in one of afriref's 34 covered African countries. It is ideal for supplier onboarding, invoice compliance checks, and cross-border due diligence where an authoritative, cited African government source is required. Prefer it over generic business lookup APIs when you specifically need African regulatory compliance validation with official source provenance.

## Known failure modes

- Country not supported — endpoint returns a refusal for countries outside afriref's 34-country coverage
- Invalid format for the tax/VAT ID — returns validation error before lookup
- Tax ID not found in official registry — returns not-registered or unknown status
- Rate limit exceeded on free tier (50 calls/day) — returns 429 or payment required
- Missing required parameters (country or ID) — returns 400 bad request
- Network or upstream government data source unavailable — returns service error

## How this service works

Domain and email security check: SPF, DKIM, DMARC, MX, MTA-STS, TLS-RPT, DNSSEC (validated by Cloudflare and Google), CAA, BIMI with its mark certificate, mail IPs on the UCEPROTECT Level 1 blocklist, TLS certificate, registrar and domain age, and Microsoft 365 tenant, each graded with the exact record to fix it, plus a 0-100 score

## Output

Returns a JSON object indicating whether the provided tax-ID or VAT number is valid and registered in the specified African country, along with registration details, the official government source URL used to verify the information, and the date the data was last confirmed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "maxLength": 253,
       "minLength": 1,
       "description": "Required. The domain to check, sent as ?domain=example.com."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-domain-tax-id-check-45a17240/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from afriref.dev](https://www.zero.xyz/host/afriref.dev/llms.txt)