Skip to main content
GET
/
evidence
Lists evidence with optional filters.
curl --request GET \
  --url https://api.example.com/evidence
[
  {
    "cid": "<string>",
    "evidence_type": "<string>",
    "gateway_url": "<string>",
    "blockchain_tx": "<string>",
    "captured_at": "<string>",
    "drone_id": "<string>",
    "incident_id": "<string>"
  }
]

Query Parameters

​
incident_id
string | null

Filter evidence by associated incident ID.

​
drone_id
string | null

Filter evidence by capturing drone ID.

​
evidence_type
string | null

Filter by evidence type (e.g. "image", "video").

​
start_time
integer<int64> | null

Unix timestamp lower bound for filtering by capture time.

​
end_time
integer<int64> | null

Unix timestamp upper bound for filtering by capture time.

Response

200 - application/json

List of evidence

​
cid
string
required

IPFS content identifier (primary key).

​
evidence_type
string
required

Evidence classification (e.g. "image", "video", "sensor").

​
gateway_url
string
required

IPFS gateway URL for accessing the evidence file.

​
blockchain_tx
string | null

Blockchain transaction hash anchoring this evidence.

​
captured_at
string | null

RFC 3339 timestamp when the evidence was captured.

​
drone_id
string | null

Identifier of the drone that captured the evidence.

​
incident_id
string | null

Incident this evidence is linked to, if any.