GET/api/v1/usage/exports/{export_id}

Get a usage export's status

Reads job state; never mints a download link. A job past expires_at reads expired even before cleanup runs.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • export_idstring必須

    Export job id (uuid) from the create response.

レスポンス

  • 200

    The export job.

    レスポンス
    • idstring
    • statusenum
      "queued""running""completed""failed""expired"
    • api_key_idstring
    • start_atstring
    • end_atstring
    • created_atstring
    • formatenum
      "jsonl"
    • compressionenum
      "gzip"
    • schema_versionenum
      1
    • snapshot_atstring | null
    • row_countinteger | null
    • byte_sizeinteger | null

      Compressed file size, bytes.

    • sha256string | null

      Hex SHA-256 of the file.

    • expires_atstring | null
    • error_codestring | null
  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    No export with this id for your organization.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

リクエスト

curl https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63 \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "id": "6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63",
  "status": "completed",
  "api_key_id": "0b9d4f6e-2a1c-4e8b-9f37-5c6d2e1a8b40",
  "start_at": "2026-10-20T00:00:00Z",
  "end_at": "2026-11-19T00:00:00Z",
  "created_at": "2026-11-19T16:02:44.118Z",
  "format": "jsonl",
  "compression": "gzip",
  "schema_version": 1,
  "snapshot_at": "2026-11-19T16:02:51.004Z",
  "row_count": 48211,
  "byte_size": 3918442,
  "sha256": "9f2c4e81b7a05d3c6e1f8a2b4d7c9e0f1a3b5c7d9e2f4a6b8c0d1e3f5a7b9c2d",
  "expires_at": "2026-11-26T16:03:10.551Z",
  "error_code": null
}

https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63