Sessions

GET

sessions

curl --request GET \
  --url https://api.flyingraccoon.tech/sessions \
  --header 'raccoon-secret-key: <api-key>'

{
  "sessions": [
    {
      "executionTime": 30,
      "executionType": "extract",
      "inputs": {
        "param2": "value2",
        "url": "https://another-example.com"
      },
      "output": [
        {
          "extracted_data1": "value1"
        },
        {
          "extracted_data2": "value2"
        }
      ],
      "raccoonPasscode": "raccoon_secret_456",
      "sessionId": "session_xyz789012",
      "status": "success",
      "taskId": "task_abcdef123456",
      "timestamp": 1678972800
    }
  ],
  "meta": {
    "totalPages": 5,
    "totalRecords": 50,
    "currentPage": 1
  }
}

Authorizations

raccoon-secret-key

string

header

required

Query Parameters

start_time

integer | null

Filter sessions created after this Unix timestamp (in milliseconds).

Example:

1678886400000

end_time

integer | null

Filter sessions created before this Unix timestamp (in milliseconds).

Example:

1678972800000

session_id

string | null

Filter sessions by a specific session ID.

Example:

"session_456"

task_id

string | null

Filter sessions by a specific task ID.

Example:

"task_123"

page

integer | null

default:1

Page number for pagination.

Required range: x >= 1

Example:

2

limit

integer | null

default:10

Number of sessions per page (maximum 100).

Required range: 1 <= x <= 50

Example:

15

executionType[]

enum<string>[] | null

Filter sessions by execution type (e.g., 'run', 'extract').

Available options:

run,

extract,

fleet

Example:

["run"]

sort_by

enum<string> | null

default:timestamp

Field to sort sessions by (e.g., 'timestamp', 'executionTime').

Available options:

timestamp,

executionTime,

taskId,

status,

executionType

Example:

"timestamp"

sort_order

enum<string> | null

default:descend

Sort order ('ascend' or 'descend').

Available options:

ascend,

descend

Example:

"ascend"

raccoon_passcode

string | null

Filter sessions by Raccoon passcode.

Example:

"code456"

Response

200

application/json

Successful Response

sessions

object[]

required

List of sessions.

sessions.sessionId

string

required

Unique identifier for the session.

Example:

"session_xyz789012"

sessions.executionType

enum<string>

required

The type of execution performed (e.g., 'run', 'extract').

Available options:

run,

extract,

fleet

Example:

"extract"

sessions.status

enum<string>

required

Current status of the session.

Available options:

success,

failure,

running

Example:

"success"

sessions.inputs

object

required

Input parameters used for the session.

Example:

{
  "param2": "value2",
  "url": "https://another-example.com"
}

sessions.output

object[]

required

Output generated by the session.

Example:

[
  { "extracted_data1": "value1" },
  { "extracted_data2": "value2" }
]

sessions.raccoonPasscode

string

required

Passcode associated with the user.

Example:

"raccoon_secret_456"

sessions.taskId

string

required

Unique identifier for the associated task.

Example:

"task_abcdef123456"

sessions.executionTime

integer

required

Time taken for the session execution (in milliseconds).

Example:

30000

sessions.timestamp

integer

required

Unix timestamp (in milliseconds) indicating when the session was created.

Example:

1678972800000

Example:

[
  {
    "executionTime": 30,
    "executionType": "extract",
    "inputs": {
      "param2": "value2",
      "url": "https://another-example.com"
    },
    "output": [
      { "extracted_data1": "value1" },
      { "extracted_data2": "value2" }
    ],
    "raccoonPasscode": "raccoon_secret_456",
    "sessionId": "session_xyz789012",
    "status": "success",
    "taskId": "task_abcdef123456",
    "timestamp": 1678972800
  }
]

SDKs

APIs

Authorizations

Query Parameters

Response