---
updatedAt: 2025-11-11T21:52:52.000Z
agentTools:
  projectIndex: https://docs.woopra.com/llms.txt
---

# /logs/export

Export Woopra logs as JSON separated lines, each line contains an entire session (visit).

# Parameters

## `file`

To tell Woopra which file you would like to export, you simply send it the name of the log file.  This is also the PST date of the log file having the format yyyy-MM-dd. Ex: 2015-02-01 is the log file for Feb 1st, 2015. Log files are rotated at midnight PST. It is a good practice to send an http HEAD request to the same endpoint to get the current log file name.

## `pos` (Paging or Streaming)

Each response will contain two headers: `X-Woopra-NextFile` and `X-Woopra-NextPos`  You can use these to programmatically determine what parameters to use for your next call so as to avoid any duplicate lines coming in.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "data-api",
    "version": "3.5"
  },
  "servers": [
    {
      "url": "https://www.woopra.com/rest/3.10"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/logs/export": {
      "get": {
        "summary": "/logs/export",
        "description": "Export Woopra logs as JSON separated lines, each line contains an entire session (visit).",
        "operationId": "export-logs",
        "parameters": [
          {
            "name": "project",
            "in": "query",
            "description": "Enter the name of your Woopra project here.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "epoch",
            "in": "query",
            "description": "Log file epoch - matches the yyyy-MM-dd epoch in PST time",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "pos",
            "in": "query",
            "description": "Position of the log file in question. Minimum value is 0.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          }
        ],
        "responses": {
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```