FlintflintDocs

API request logs

API request logs let you inspect recent public API traffic made with the current API key. Use them to debug auth failures, repeated retries, unexpected 4xx/5xx responses, which resource a request targeted, and whether a sandbox-bound test key is hitting the expected sandbox routes.

This surface is intentionally scoped to the calling key (it is not a merchant-wide audit log across every key). The list returns request summaries only: method, route, status, latency, resource, and error code. The detail endpoint adds redacted headers and, for eligible write requests, redacted request and response bodies, plus a ready-to-run reproduction; credentials, card data, and personal data are always replaced with [REDACTED] before storage. Listing requires the developer.logs.self.read scope and detail requires developer.logs.self.detail.read.

The Debugging guide walks the full workflow, from a request_id to a diagnosis to a resource timeline. Pair it with the Error handling guide to map error codes to fixes, and the Testing guide for the sandbox testing loop.

Endpoints

List API request logs for the current API key#

GET/v1/developer/request-logs

Returns request log summaries generated by the authenticated API key. Results are always scoped to the calling key. Full request and response bodies are intentionally omitted from this public API surface to reduce the risk of sensitive data leakage.

Query parameters
page_sizeinteger

Page size, default 20, max 100.

page_tokenstring

Cursor returned by the previous list response.

request_idstring

Filter by Flint request ID.

http_methodstring

Filter by HTTP method.

path_querystring

Filter by request path substring.

resource_typestring

Filter by resource type.

resource_idstring

Filter by resource ID.

status_bucketenum

Filter by response status bucket.

allsuccessclient_errorserver_error
created_afterstring

RFC3339 lower bound for created_at.

created_beforestring

RFC3339 upper bound for created_at.

Response · 200
dataarray of objectrequired
metaobject
next_page_tokenstring
request_idstring
Bash
curl https://api.withflintpay.com/v1/developer/request-logs \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": [
    {
      "api_request_log_id": "rlog_123",
      "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6",
      "correlation_id": "rlog_123",
      "http_method": "GET",
      "path": "/v1/orders/ord_123",
      "route_pattern": "GET /v1/orders/{order_id}",
      "status_code": 200,
      "latency_milliseconds": 12,
      "resource_type": "order",
      "resource_id": "ord_123",
      "created_at": "2026-03-17T14:30:00Z"
    }
  ],
  "next_page_token": "Zm9yd2FyZC1vbmx5LW9wYXF1ZS1jdXJzb3I",
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Get API request log detail for the current API key#

GET/v1/developer/request-logs/{api_request_log_id}

Returns redacted request log detail for a request generated by the authenticated API key. Detail responses remain current-key scoped and redact headers, query parameters, request bodies, and response bodies before returning them.

Path parameters
api_request_log_idstringrequired

Flint API request log ID.

Response · 200
dataobjectrequired
metaobject
request_idstring
Bash
curl https://api.withflintpay.com/v1/developer/request-logs/rlog_123 \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "api_request_log_id": "rlog_123",
    "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6",
    "correlation_id": "rlog_123",
    "http_method": "POST",
    "path": "/v1/payment-intents",
    "query_params": null,
    "route_pattern": "POST /v1/payment-intents",
    "status_code": 400,
    "latency_milliseconds": 42,
    "request_headers": {
      "content-type": "application/json"
    },
    "request_body": {
      "amount": 2500,
      "currency": "USD",
      "payment_source_token": "[REDACTED]"
    },
    "response_body": {
      "error": {
        "code": "VALIDATION_ERROR",
        "message": "payment_source_token is invalid."
      }
    },
    "response_content_type": "application/json",
    "resource_type": "payment_intent",
    "resource_id": "pi_123",
    "error_code": "VALIDATION_ERROR",
    "error_category": "validation",
    "error_summary": "The request payload or query parameters did not pass validation.",
    "retryable": false,
    "recommended_action": "Fix the field identified by the error response, then retry with the same idempotency key if this was the same logical operation.",
    "created_at": "2026-03-17T14:30:00Z",
    "reproduction": {
      "http_method": "POST",
      "path": "/v1/payment-intents",
      "query_params": null,
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "Idempotency-Key": "<NEW_IDEMPOTENCY_KEY>"
      },
      "body": {
        "amount": 2500,
        "currency": "USD",
        "payment_source_token": "[REDACTED]"
      },
      "curl": "curl -X POST https://api.withflintpay.com/v1/payment-intents -H \"Authorization: Bearer <API_KEY>\" -H \"Idempotency-Key: <NEW_IDEMPOTENCY_KEY>\" --data '<REDACTED_OR_CAPTURED_BODY>'",
      "safe_to_reproduce": false,
      "reproduction_complete": false,
      "redactions_present": true,
      "recommended_environment": "test",
      "warnings": [
        "This request may mutate live data; reproduce in test mode unless you have verified it is safe."
      ]
    }
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Get a resource timeline#

GET/v1/developer/resource-timelines/{resource_id}

Returns summary-only API request, webhook event, and webhook delivery attempt entries for a single public API resource. The caller must have developer.resource_timelines.read and the matching read scope for the requested resource type.

Path parameters
resource_idstringrequired

Flint public API resource ID.

Query parameters
resource_typestring

Optional resource type. Must match the resource_id prefix when present.

includearray of enum

Optional comma-separated timeline entry groups. Defaults to requests,webhooks,attempts.

requestswebhooksattempts
page_sizeinteger

Page size, default 20, max 100.

page_tokenstring

Cursor returned by the previous timeline response.

occurred_afterstring

RFC3339 lower bound for occurred_at.

occurred_beforestring

RFC3339 upper bound for occurred_at.

Response · 200
dataobjectrequired
metaobject
next_page_tokenstring
request_idstring
Bash
curl https://api.withflintpay.com/v1/developer/resource-timelines/ord_123 \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "resource_id": "pi_123",
    "resource_type": "payment_intent",
    "test": true,
    "entries": [
      {
        "entry_type": "api_request",
        "resource_timeline_entry_id": "rlog_123",
        "occurred_at": "2026-03-17T14:30:00Z",
        "test": true,
        "resource_type": "payment_intent",
        "resource_id": "pi_123",
        "api_request_log_id": "rlog_123",
        "correlation_id": "rlog_123",
        "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6",
        "http_method": "POST",
        "path": "/v1/payment-intents/pi_123/confirm",
        "route_pattern": "POST /v1/payment-intents/{payment_intent_id}/confirm",
        "status_code": 200,
        "latency_milliseconds": 42
      },
      {
        "entry_type": "webhook_event",
        "resource_timeline_entry_id": "whev_123",
        "occurred_at": "2026-03-17T14:30:01Z",
        "test": true,
        "resource_type": "payment_intent",
        "resource_id": "pi_123",
        "api_request_log_id": "rlog_123",
        "correlation_id": "rlog_123",
        "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6",
        "status": "delivered",
        "webhook_event_id": "whev_123",
        "webhook_endpoint_id": "whep_123",
        "event_type": "payment_intent.succeeded",
        "event_source": "business_event",
        "automatic_attempt_count": 1,
        "max_attempts": 9
      },
      {
        "entry_type": "webhook_delivery_attempt",
        "resource_timeline_entry_id": "watt_123",
        "occurred_at": "2026-03-17T14:30:02Z",
        "test": true,
        "resource_type": "payment_intent",
        "resource_id": "pi_123",
        "api_request_log_id": "rlog_123",
        "correlation_id": "rlog_123",
        "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6",
        "status": "delivered",
        "status_code": 200,
        "webhook_event_id": "whev_123",
        "webhook_delivery_attempt_id": "watt_123",
        "delivery_trigger": "automatic_delivery",
        "attempt_number": 1,
        "duration_milliseconds": 98
      }
    ]
  },
  "next_page_token": "Zm9yd2FyZC1vbmx5LW9wYXF1ZS1jdXJzb3I",
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}
Rate this doc