Database
Metadata
Returns publish freshness information for the currently published version of the requested database: when it was last updated, how many entries the dataset contains, and the size of each output format in bytes.
Authorization
ApiKeyAuth apikey<token>
UUID-format API key issued to the customer. Each key is authorized for a specific set of database ids; requesting any other id returns 403.
v1 only. The v2 endpoints take a console-issued key as a bearer token.
In: query
Query Parameters
id*string
Database identifier (e.g. vpn_ip_v1, resproxy_provider_v1).
Match
^[a-zA-Z0-9_]+$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://internetdata.io/api/v1/database/metadata?id=vpn_ip_v1"{
"rc": "SUCCESS",
"data": {
"updated": "2026-04-25",
"entries": 114000000,
"size": {
"csvgz": 0,
"mmdb": 0
}
}
}{
"rc": "INVALID_FORMAT"
}{
"rc": "INVALID_APIKEY"
}{
"rc": "UNAUTHORIZED_ID"
}{
"rc": "DB_NOT_FOUND"
}