# InternetData Database v2 API

**Canonical:** https://apis.io/apis/internetdata-io/internetdata-io-database-v2-api/  
**Provider:** InternetData — https://apis.io/providers/internetdata-io/  
**Base URL:** https://internetdata.io  
**Documentation:** https://docs.internetdata.io/api

InternetData Database v2 API is one of 6 APIs that [InternetData](https://apis.io/providers/internetdata-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Database v2. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The current database API. Authenticate with an API key carrying the `db.download` scope, presented any of three ways: `Authorization: Bearer <key>`, `X-Api-Key: <key>`, or `?apikey=<key>`. They are the same key; the query parameter is there for curl and the browser, which is how a database is usually fetched. Access is granted by CONTRACT, one dataset family at a time: there is no self-service purchase and no subscription behind it. The Open databases are licensed to every organization from the start, a `standard` license to each, and are free under CC BY-SA 4.0 besides. `list` marks them `open`. A successful download answers `302` with a time-limited URL pointing straight at object storage. Follow the redirect (`curl -L`); the link authorizes the START of a transfer, so a download already running is not interrupted when it lapses.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/database/list` | List |
| GET | `/api/v2/database/download` | Download |
| GET | `/api/v2/database/metadata` | Metadata |
| GET | `/api/v2/database/checksum` | Checksums |
| GET | `/api/v2/database/downloads` | History |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/internetdata-io/openapi/internetdata-io-database-v2-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-database-schema.json
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-token-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-database-metadata-schema.json
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-oauth-metadata-schema.json
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-download-schema.json
- **JSONSchema** — https://artifacts.apis.io/internetdata-io/json-schema/internetdata-io-token-request-schema.json

## Other InternetData APIs (5)

- [InternetData Account API](https://apis.io/apis/internetdata-io/internetdata-io-account-api/)
- [InternetData API keys API](https://apis.io/apis/internetdata-io/internetdata-io-api-keys-api/)
- [InternetData Authorization API](https://apis.io/apis/internetdata-io/internetdata-io-authorization-api/)
- [InternetData Database API](https://apis.io/apis/internetdata-io/internetdata-io-database-api/)
- [InternetData Organization API](https://apis.io/apis/internetdata-io/internetdata-io-organization-api/)

## Tags

Database v2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/internetdata-io/internetdata-io-database-v2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/internetdata-io/.