Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hedera airdrops API

The airdrops API from Hedera — 2 operation(s) for airdrops.

Hedera airdrops API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include airdrops. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 2 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

2 operations 2 paths 10 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
License
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

airdrops 2
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/airdrops/outstanding
Get outstanding token airdrops sent by an account
getOutstandingTokenAirdrops 6 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/airdrops/pending
Get pending token airdrops received by an account
getPendingTokenAirdrops 6 params → 200400404

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are TokenAirdrop (6 properties), TokenAirdropsResponse (2 properties), TimestampRange (2 properties), Error (1 property). Each schema is shown below with its type and property counts.

EntityIdQuery
string
TimestampRange
object
A timestamp range an entity is valid for
2 properties
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
TokenAirdrop
object
6 properties 5 required
TokenAirdropsResponse
object
2 properties
Links
object
1 property
EntityId
stringnull
Network entity ID in the format of shard.realm.num
Timestamp
string
A Unix timestamp in seconds.nanoseconds format
Error
object
1 property
TokenAirdrops
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-airdrops-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera accounts API
Hedera balances API
Hedera blocks API
Hedera contracts API
Hedera network API
Hedera schedules API
Hedera tokens API
Hedera topics API
Hedera transactions API