Api Endpoint

Afriref - Africa reference data

Bulk snapshot of every Pan-African government reference series in one JSON file for 34 African countries: policy rates, VAT/GST, statutory interest, minimum wages, CPI, income, corporate and withholding tax, social contributions and holidays, plus official FX reference rates. Every value cited with source URL, effective date and last_confirmed. Suited to caching the full dataset; single values are GET /v1/{country}/{series}.

Open interactive test console

Offering

Provider
afriref.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Data
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://afriref.dev/v1/all
MIME type
application/json
First seen
2026-10-16T01:52:52.778Z
Last seen
Tags
reference-data, Snapshot, bulk, africa

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6"
  }
]

Observed health

Status
Healthy
Latest latency
1341 ms
Average latency
1239 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {},
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {},
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "description": "One entry per country, each with all its series values",
          "items": {
            "properties": {
              "country": {
                "description": "ISO 3166-1 alpha-2 country code",
                "type": "string"
              },
              "series": {
                "items": {
                  "properties": {
                    "components": {
                      "description": "Optional. Breakdown of a composite rate into its named statutory components (present only where applicable, e.g. Ghana VAT).",
                      "items": {
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "rate": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "name",
                          "rate"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "country": {
                      "description": "ISO 3166-1 alpha-2 country code",
                      "type": "string"
                    },
                    "effective_from": {
                      "format": "date",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "effective_from_basis": {
                      "description": "Optional. Absent: effective_from is the date the value became the law (a genuine change point). 'restatement': effective_from is the date the value's CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date.",
                      "enum": [
                        "restatement"
                      ],
                      "type": "string"
                    },
                    "effective_rate": {
                      "description": "Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value.",
                      "type": "number"
                    },
                    "last_confirmed": {
                      "description": "When this value was last verified against the official source",
                      "format": "date",
                      "type": "string"
                    },
                    "notes": {
                      "type": "string"
                    },
                    "series": {
                      "type": "string"
                    },
                    "source": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "url": {
                          "format": "uri",
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "url"
                      ],
                      "type": "object"
                    },
                    "stale": {
                      "description": "True when past the expected update cycle — treat with caution",
                      "type": "boolean"
                    },
                    "unit": {
                      "type": "string"
                    },
                    "value": {
                      "description": "Number for rates/wages; array of {date,name} for holiday calendars"
                    }
                  },
                  "required": [
                    "country",
                    "series",
                    "value",
                    "effective_from",
                    "last_confirmed",
                    "source",
                    "stale"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "country",
              "series"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}