Documentation
LogsGET

List Logs

Paginated, filterable request log for the authenticated org. Use GET /v1/logs/ when you need this capability from your application or backend. It does not require a request body. Query parameters are available for request scoping and filtering.

Endpoint

Use this full URL directly in server-side integrations, scripts, or internal tooling.

GET request
https://api.dropfakes.com/api/v1/logs
Full endpoint URL
GET https://api.dropfakes.com/api/v1/logs

Authorization

This section explains how this endpoint should be called in the current API version.

No authorization required
This endpoint is documented as public in this version of the API reference. No bearer token is required.
Authorization
Authorization: dk_live_*****

Code examples

Start with curl, then use the language sample that matches your backend.

curl
curl -X GET "https://api.dropfakes.com/api/v1/logs?page=1&perPage=50&verdict=value&startDate=value&endDate=value&email=value&apiKeyId=value"

Parameters

Query string parameters and request body fields are listed together for faster scanning.

NameLocationTypeRequiredDescriptionDefault
pagequeryintegerNoQuery parameter for `page`.1
perPagequeryintegerNoQuery parameter for `perPage`.50
verdictquerystringNoQuery parameter for `verdict`.-
startDatequerystring (date)NoQuery parameter for `startDate`.-
endDatequerystring (date)NoQuery parameter for `endDate`.-
emailquerystringNoQuery parameter for `email`.-
apiKeyIdquerystringNoQuery parameter for `apiKeyId`.-

Success response

The primary success status for this operation is 200.

Status 200
Successful Response
200 application/json
{
  "data": [
    {
      "id": "id_123",
      "email": "person@example.com",
      "endpoint": "string",
      "verdict": "allow",
      "riskScore": 0.08,
      "statusCode": 1,
      "latencyMs": 142,
      "apiKeyName": "Primary key",
      "ipAddress": "string",
      "countryCode": "US",
      "timestamp": "2026-03-21T10:15:00.000Z"
    }
  ],
  "pagination": {}
}

Error response

Use this example to handle validation and request errors safely on the client or backend.

Status 422
Validation Error
422 application/json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}